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CAPÍTULO 1 


Introducáo 


1.1 MOTIVAÇÃO: MOBILE 


O mercado iOS cresce cada vez mais no Brasil, e se a decisão de uma empresa 
ou indivíduo é a de criar aplicações nativas, a escolha prática para o mundo 
iOS acaba sendo entre Objective C ou Swift. 

Como uma linguagem nova e beta, Swift ainda possui espaço para peque- 
nas mudanças que podem alterar a maneira de um programador desenvolver 
uma aplicação, mas nesse instante a Apple já a considera madura o suficiente 
para que novos aplicativos possam ser criados com ela. 

Por ser nova, foram trazidos conceitos que estão em voga na comunidade 
de desenvolvimento em geral, como podemos ver a influência da linguagem 
Scala em Swift. 

Como uma linguagem compilada e com uma IDE rica, recebemos mui- 
tas notificações de possíveis erros ainda em tempo de desenvolvimento, o que 
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evita diversos erros tradicionais, como o acesso a ponteiros inválidos na me- 
mória, algo muito fácil de se proteger em Swift. 

Para desenvolvedores novos no mundo iOS, este livro busca ser um guia 
que ensina diversas partes da linguagem e da API disponível durante a criação 
e manutenção de uma aplicação mobile completa. 

Todos os níveis de desenvolvedores podem se beneficiar dos conceitos de 
boas práticas, code smells, refatorações e design patterns apresentados no livro. 


1.2 MOTIVAÇÃO: BOAS PRÁTICAS E CODE SMELLS 


O objetivo desse livro não é somente guiá-lo através de sua primeira aplicação 
iOS, mas sim de ser capaz de julgar por si só o que é uma boa estratégia de 
programação, por meio da introdução de uma dezena de boas práticas e code 
smells que facilitam ou dificultam a manutenção do código com o passar do 
tempo. 

Um code smell é um sinal forte de que existe algo de estranho no código, 
não uma garantia de que exista um problema. Da mesma forma, boas práticas 
e design patterns possuem situações específicas que podem trazer mais mal 
do que benefícios. Como fazemos no livro, toda situação encontrada deve ser 
analisada friamente: qual o custo de manter o código como está e qual o custo 
de refatorá-lo? 

Saber pesar e tomar decisões como essa diferenciam um programador 
iniciante de um profissional e é isso que buscamos aqui: não somente ensinar 
a programar, mas sim criar profissionais em nossa área. 

São dezenas de boas práticas, design patterns e code smells catalogados 
no decorrer do livro que podem ser acessados diretamente através do índice 
remissivo. 


1.3 AGRADECIMENTOS 


Gostaria de agradecer ao desafio proposto pelo Paulo Silveira e o Adriano 
Almeida. Não é fácil escrever um livro de boas práticas de linguagem e API 
quando uma é tão nova e a outra carregada de decisões antigas. É delicado 
entender as implicações de cada decisão da linguagem, mas o aprendizado 
que passamos por este projeto é o que trouxe a ele tanto valor. 
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Um agradecimento especial ao Hugo Corbucci que tanto nos ajudou na 
revisão do livro, e ao Rodrigo Turini, ambos compartilharam conosco os bugs, 
as dificuldades e as alegrias de utilizar e ensinar uma linguagem ainda em 
desenvolvimento. Agradecemos também pelas conversas e discussóes de pa- 
dróes e boas práticas com o Maurício Aniche, além do Francisco Sokol, Diego 
Chohfi, Ubiratan Soares e outros. 


CAPÍTULO 2 


Projeto: nossa primeira App 


2.1 INSTALANDO O XCODE 


O processo de instalacáo do Xcode se tornou bem simples, basta acessar a 
Apple Store e procurar pelo Xcode. Clique em instalar. 
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Featured Top Charts — Categ 





Search Results for "xcode" 


Xcode £4 Tutorial for Xcode 
Developer Tools Developer Tools 
Xo 8 Ratings CIÓN Gp 

Gab 





Tutorial for XCode Training for Xcode 
Developer Tools Developer Tools 
CAD CAD 





Se você deseja usar uma versão beta do Xcode, entre no programa de beta 
developers da Apple e siga o link de download de uma versão beta. Cuidado, 
versões beta podem sofrer alterações e quebrar a qualquer instante - e que- 
bram. 


2.2 NOSSA PRIMEIRA APP 


Nossa aplicação será um gerenciador de calorias e felicidade. Como usuário 
final eu faço um diário das comidas que ingeri, indicando quais alimentos 
estavam dentro dela e o quão feliz fiquei. Meu objetivo final seria descobrir 
quais alimentos me deixam mais felizes com o mínimo de calorias possíveis, 
um paraíso. 

Para isso será necessário cadastrar refeições ( Meal) e para cada refeição 
queremos incluir os itens ( Item) que a compõem. Desejamos listar essas re- 
feições e fazer o relacionamento entre esses dois modelos, afinal uma refeição 
possui diversos itens, além de armazenar todos esses dados no celular. 


Por fim, veremos o processo de execução de nossa app em um simulador, 
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e o de deploy de nossa app tanto em um celular particular para testes quanto 
na app store. 

Isso tudo será intercalado com seções de boas práticas de desenvolvi- 
mento de softwares e caixas de informações extras, ambos ganchos para que 
vocé possa se tornar um bom programador à medida que pesquisa a infor- 
mação contida nessas seções e se aprofunda nelas. Não se sinta obrigado a 
pesquisá-las no mesmo momento que as lê, sugiro, inclusive, que você ter- 
mine primeiro o conteúdo aqui apresentado para só então se aprofundar. 
Dessa forma, terá uma opinião mais formada sobre diversos itens ao entrar 
nessas discussões avançadas sobre qualidade de código, usabilidade etc. 

Ao término de nossa jornada, teremos uma aplicação com diversas fun- 
cionalidades, entre elas, adicionar novas refeições: 
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iOS Simulator - iPhone 6 - iPhone 6 / iOS 8.1 (12B411) 


Carrier = 4:18 AM Em 
< Back new item 
Name 
Happiness 
Add 


Eggplant Brownie 
Zucchini Muffin 
Cookie 

Coconut oil 
Chocolate frosting 
Chocolate chip 


sundubu 
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Visualizar seus detalhes e remové-las desejado: 


Zucchini Muffin 
Happiness: 3 


Remove Cancel 





Pronto para começar? 


2.3  VIEWCONTROLLER DE CADASTRO DE REFEIÇÃO 


Vamos criar uma nova aplicação. No Xcode, escolhemos “Criar um novo pro- 
jeto” e, no Wizard que segue, escolhemos iOS, SingleViewApplication, 
que seria uma aplicação de uma tela só. Aos poucos, evoluiremos a mesma 
para mais telas. O nome do nosso projeto é eggplant-brownie e a orga- 
nização br.com.alura. 

Escolhemos a linguagem swift e nosso alvo será o iPhone. A tela de 
criação fica então como a seguir: 
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Choose options for your new project: 





Product Name: | eggplant-brownie 





Organization Name: Alura 


Organization Identifier: |br.com.alura 
Bundle Identifier: br.com.alura.eggplant-brownie 


Devices: | iPhone * 


Use Core Data 








Cancel | | Previous | [Next] 





Logo de cara abriremos a nossa janela de criação de interface prin- 
cipal: o storyboard (chamado Main.storyboard dentro da pasta 
eggplant-brownie). Ao clicarmos nele, somos capazes de ver uma 
janela quadrada que será a primeira tela de nossa aplicação: nosso 
ViewController. O View Controller é chamado assim tanto por ser 
responsável pela View quanto por fazer o controle do que será executado ao 
interagirmos com essa View. 

Tem algo de estranho aqui, nossa tela está quase quadrada e sabemos que 
um iPhone não é quadrado. Vamos escolher o view controller clicando no 
quadrado e, em seguida, no botão amarelo que aparece no topo à esquerda 


do quadrado: 
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eoo [E Main.storyboard 


eggplant-brownie: Ready | Today at 20:53 












Ej: Q A O zm o E IE os » | [E eggplant-brownie > eggplant-brownie? [| Main.storyboard ^ [| Main. 
eggplant-brownie 
2 targets, iOS SDK 8.0 
Y [5] eggplant-brownie 
'» AppDelegate.swift 
[a] ViewController.swift 
EB Images.xcassets 
| LaunchScreen.xib 
b [5] Supporting Files 
» | -] eggplant-brownieTests 
» C Products 





View Controller 

















No lado direito, podemos navegar entre diversas propriedades do atual 
elemento escolhido. Na aba Attributes, temos uma seção chamada 
Simulated Metrics onde alteramos a opção size, escolhendo iPhone 


4-inch. Agora sim temos um tamanho compatível com um iPhone de 
4 polegadas. 





» @ view Controller 








Orientation 
Status Bar | Inferred $ 


Top Bar | Inferred $ | 
Bottom Bar | Inferred $ 











Desejamos adicionar duas mensagens de texto e dois campos de texto, um 
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para o nome da comida ( name) e outro para o nível de felicidade com ela ( 
happiness). Primeiro, buscamos na barra de componentes (canto inferior 
direito) um campo chamado Label: 


O O E 


Label - A variably sized amount of 
Label static text. 


EB (A) Label ) 


E agora o arrastamos duas vezes para nosso ViewController. O resul- 
tado são dois labels com nomes sem sentido: 
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Precisamos trocar seus valores. Afinal, um representará o nome e o outro 
nosso nível de felicidade com aquela comida. Um duplo clique no label 
permite alterar seu valor. Mudemos para Name e Happiness: 
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Name: 


Happiness: 
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Adicionamos agora dois campos de Text Field da mesma forma, um 
para Name e um para Happiness. No mesmo canto inferior direito, procu- 
ramos por Text Field e arrastamos o resultado duas vezes. 

Colocamos um botão, procurando pelo componente chamado Button 
e, assim como com outros componentes, mudamos seu texto para add. 


O resultado de nosso storyboard é esse: 
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Name: 


Happiness: 
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O próximo passo é rodar nosso programa em um iPhone. Mas calma lá, 
eu não tenho um iPhone 4, 5, 6 etc., a todo instante. Quero primeiro ver como 
ficaria em um iPhone no meu computador, entáo vamos simular um iPhone. 
Para isso clicamos no botáo Play que fica no canto superior esquerdo da 
janela. 












v B egaplant-brownie 
2 targets, 105 SDK 8.1 


* | leggplant-brownie 

(=| AppDelegate.swift 
[a] ViewController.swift 
Main.storyboard 
EM] Images.xcassets 





Poderíamos rodar em outro iPhone, repare que podemos trocar o modelo 
a qualquer instante que desejarmos. Por exemplo, ao escolher um iPhone 5: 
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mon — tx M - E 









iPhone 5 

















RSS Wi iPhone 5s 
Mendo Wi iPhone 6 Plus a 
eggplant-brownie 
* & 2 targets, iOS SDK 8.1 Wi iPhone 6 
v [] eggplant-brownie Wi Resizable iPad 
>| AppDelegate.swift Wå Resizable iPhone 






|) ViewController.swift 
[fj Main.storyboard 






O resultado é a tela de nosso programa rodando: 


Name: 





Happines 
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Podemos diminuir o zoom do emulador escolhendo, na aplicação ios 
Simulator, menu Window, submenu Scale ea opção que acharmos mais 
adequada. Podemos também optar por mostrar o teclado em nosso emu- 
lador no menu Hardware, submenu Keyboard e Toggle software 


keyboard. 





EMULADOR OU SIMULADOR? 


Um emulador emula também o hardware, o simulador utiliza o hard- 
ware da máquina onde está rodando (host). No nosso caso, estamos 
usando um simulador, com o hardware de nossa máquina, portanto 
nossa aplicação rodará em geral mais rápido do que em um iPhone de 
verdade. Lembre-se sempre disso antes de colocar uma aplicação que 
abusa de processamento disponível para o mundo: você quer rodá-la em 
um emulador ou em seu celular antes para conferir seu desempenho. 











Ainda tem algo de estranho em nossa aplicação, o campo de felicidade 
permite digitar texto. Não desejamos isso. Podemos parar o emulador cli- 
cando no botão de stop no canto superior esquerdo. 
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= B egaplant-brownie 
2 targets, POS SDK 8.1 


y| lJeggplant-brownie 

[4] AppDelegate.swift 
[a] ViewController.swift 
[B Main.storyboard - 
[en] Images.xcassets 









Ao selecionarmos um campo de texto como o de felicidade, notamos que 
à direita, na aba de propriedades, ao final das informações para Text Field, 
temos uma opção que indica o tipo de teclado, o Keyboard Type: 
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2.3. ViewController de cadastro de refeição 









| Main.storyboard — Edited 
g eggplant-brownie on iPhone 5 









[o] 

Round Style Text Field D © "0 B o 
Color | MIN | Default $ 
4 Font [System 14.0 [iu] B. 
Alignment = =| = — 
o m E 

Placeholder | Placeholder Text 

— 
Background | Background Image dv. 


Disabled [Disabled Background Imagd v | 





s 
: 














mie ) |B Mai. board) fly Mai...(Base) ^ [E] View...cene ) E) View...oller ) |. 




















Name: 
Border Style 
ü 5 Clear Button | Never appears M 
appiness: o 5 C Clear when editing begins 
Min Font Size) č — 17 
Add (Vf Adjust to Fit 
Capitalization [None .— .—  . *J| 


E ——À 
Return Key | Default $ 
[C] Auto-enable Return Key 
C Secure Text Entry 


























Vamos escolher o tipo chamado Number Pad. Escolhemos tam- 
bém um texto padrão para ficar no fundo dos dois campos de texto, 
um placeholder, que será dani's cheesecake, guilherme's 
sundubu etce 1 for sad, 5 for amazing. 


|: Main.storyboard — Edited 


1g eggplant-brownie on iPhone 5 





[| View > [F] 1 for sad, 5 for amazing Bo þ EO 














vnie » B Mai...oard ) [B Mai... Base) ^ E Vie... Scene ) @ vie...roller > 
Text | Plain $ 
p 
Text | 


e © E Color | HE | Default $ 
- * Font | System 14.0 











Alignment. 





Placeholder | 1 for sad, 5 for amazing ] 


Background | Background Image Em 


Disabled | Disabled Background lmagdv 


Border Style 


Clear Button | Never appears $ 
C) Clear when editing begins 


Name: 


Happiness: a a 
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Rodamos nosso programa clicando novamente no Play e, agora, ao cli- 
carmos no campo de texto do número, podemos verificar que o teclado que 
aparece é o teclado numérico, facilitando bastante a entrada de informações 
pelo usuário final. 


2.4 BOA PRÁTICA: PLACEHOLDER E KEYBOARD TYPE 


Formulários cuja entrada de dados náo seja do dia a dia do usuário final po- 
dem deixá-lo perdido. Um formulário de login é tào comum que náo precisa 
de placeholder e a tela fica mais limpa. Já um placeholder em um 
formulário complexo que o usuário vé pela primeira vez pode ajudá-lo a en- 
tender que tipo de valor o programa espera dele. 

Além do placeholder, o tipo de teclado ajuda o usuário ao digitar da- 
dos específicos como e-mails, números inteiros ou decimais. 


Sempre que adicionar um campo de texto em sua aplicação, lembre-se de 





configurar o placeholder eo keyboard type adequado. 





DICA: CUTUQUE AS PROPRIEDADES 


Brinque com algumas propriedades de fonte de seu componente 
Label. Mas lembre-se: é raro que uma aplicação com muitos estilos 
de fonte seja lembrada por esse fator. Evite muitas variações de fonte em 
sua aplicação. Não crie 100 estilos diferentes para 3 telas. 
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DICA: SALVANDO SEUS ARQUIVOS 


Note que toda vez que rodamos nosso programe ele é salvo automa- 
ticamente. Para perceber se seu arquivo náo está salvo, vocé verifica que 
o nome dele está em negrito ou seu ícone está escurecido: 


E] zi a A O E e E 
- B eggplant-brownie 
2 targets, 105 SDK 8.0 
v P eggplant-brownie 
a) AppDelegate.swift 
a| ViewController.swift 
E) Images.xcassets 
= LaunchScreen.xih 
p | jSupporting Files 
P eggplant-brownieTests 
b- |] Products 

















2.5 CONECTANDO A INTERFACE AO CÓDIGO 


Mas o que acontece quando clicamos no botão add? Desejamos exe- 
cutar algum código ao clicar neste botão. Para isso, abrimos o arquivo 
ViewController.swift, onde definiremos uma função em Swift. Clica- 
mos no nome do arquivo na barra esquerda: 
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eoo +) ViewController.swift — Edited 
» Ha À eggplant-brownie ) wi iPhone 5 Running eggplant-brownie on iPhone 5 
E E AL s - — - 
O RA A O E DO E || 4 p | [5 eggplant-brownie) |. eggplant-brownie > lli ViewController.swift ) No Selection 
B eggplant-brownie £s £f 
Y 2 targets, iOS SDK 8.1 2 // VWiewController.swift 
Y [5 eggplant-brownie EU. eepplónictrimmin 
> AppDelegate.swift 5 // Created by Joviane Jardim on 14/10/14. 
/Controller.s 6 // Copyright (c) 2014 Alura. All rights reserved. 
= PZA 
|) Main.storyboard E 
FS) Images.xcassets 9 import UIKit 


= LaunchScreen.xib 
» [-] Supporting Files n 
> (3 eggplant-brownieTests B override func viewDidLoad() 4 


€ 14 super.viewDidLoad() 
> [C Products 15 // Do any additional setup after loading the view, typically from a nib. 
} 


class ViewController: UIViewController { 


override func didReceiveMemoryWarning() { 

1 super.didReceiveMemoryWarning() 

20 // Dispose of any resources that can be recreated. 
) 





Quem é ele? Prazer, nosso ViewController, que já vem um compor- 
tamento mínimo: 


import UIKit 


class ViewController: UlViewController 1 
override func viewDidLoad() 1 
super. viewDidLoad () 
// Do any additional setup after loading the view, 
// typically from a nib. 


override func didReceiveMemoryWarning() 1 
super. didReceiveMemoryWarning() 
// Dispose of any resources that can be recreated. 


Os dois métodos que a IDE adicionou são opcionais, portanto os remo- 
vemos para ficarmos com nosso ViewCont roller puro: 


import UIKit 


class ViewController: UlViewController 1 
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O básico da linguagem aqui é que um ViewController herda de 
UIViewController. Só isso! O que queremos é adicionar uma função que 
será invocada quando o botão add seja clicado. Nada mais natural que defi- 
nirmos nossa função como add. Toda vez que o botão for clicado, a função 
poderá ser chamada. 


import UIKit 


class ViewController: UlViewController 1 
func add() { 


Queremos que essa funcáo seja invocada toda vez que acontecer algo com 
nossa interface com o usuário. Isto é, gostaríamos que essa função fosse 
um listener dos eventos da nossa view. Portanto, nós o anotamos de modo 
a dizer ao Interface Builder (IB) que este método de nossa classe de 
ViewController é uma ação ( Action) que será informada pela tela. O 
método é anotado como GIBAction: 


GIBAction func add( 1 


Para testar nosso callback, adicionamos uma impressáo ao log: 


OIBAction func add() 1 
printin("button pressed!") 


O log ficará na parte de baixo da tela, e aparecerá automaticamente ao 
imprimirmos algo, ou podemos mostrá-lo acessando o menu view, submenu 
Debug Area, opção Hide/Show Debug Area. 
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Esses 3 botóes (os de baixo para Yosemite e mais recente, os de cima para 
mais antigos) que se encontram no canto superior direito da janela do Xcode 
servem para esconder diferentes barras da aplicação: a barra de navegação nos 
arquivos do projeto ( Navigator, Command+1 para mostrar, Command+0 
para esconder), a barra de propriedades (Utilities) ea barra que mostra 
o console e o debug embaixo ( Debug). Utilize a cada instante o modo que 
for mais agradável para a tarefa que está efetuando. 

Rodamos o programa, como sempre, clicando em Play, e, na aplicação, 
clicamos no botão add, mas nosso log na IDE não mostra nada: 
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Claro, nós ainda não conectamos o botão add com nossa função. Po- 
demos fazer isso de diversas maneiras e a primeira que veremos aqui é feita 
arrastando o código para o botão visualmente. Mas como arrastar algo visual 
para o código se a IDE mostra somente uma coisa por vez? 

No topo, à direita do Xcode, ao lado dos ícones para exibir/esconder as 
barras, conseguimos modificar a maneira de visualizar nossa área de trabalho. 
O primeiro botão ativa a visualização tradicional que utilizamos até agora. O 
segundo ativa a visualização que permite abrir dois editores ao mesmo tempo 
e é nela que costumamos trabalhar enquanto desenvolvemos a parte visual de 
nossas apps. Vamos clicar nesse botão. 


Ex. 
DO e 


pi ug 


Abrimos o storyboard clicando na barra á esquerda e clicamos no nosso 
ViewController dentro dele. Automaticamente o assistente (a parte da di- 
reita) abre o código-fonte do controller: 
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Note a bola vazia ao lado de nosso GIBACt ion. É ela que arrastamos 
para conectar ao botáo add: 
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oos aoi E AB Qua E è DO Es 


Testamos nossa aplicação e, ao clicarmos no botão, o log indica que o 
evento ocorreu. Sucesso: 


iso: timi eggplant-brownie 
| button pressed! 


Auto * | O O O )| AlOutput? VOO | 


De volta ao Xcode, ao selecionarmos o botáo add, podemos verificar na 
última aba de propriedades ( Connections Inspector - último ícone à 
direita) que a ação Touch Up Inside invocará nossa função. 
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Main storyboard — Edited = 
Runceng eggplant-brownie on iPhone $ snr DRA 
- Bac QUA A Ho View U add BR «4 + Manual = ViewControlker.swift No Selection *x Omog O 
II ViewCon 
o? B eggolan 
- Crested by Jovione Jardim on 14/10/14 
Copyright (c) 2014 Alura. All rights reserved. 
Name: import UTKS 
ass VievController: UlvVieulontrobier ( 
Happiness: : grnct c adt) 





P button pressedi") 


+ 





Referencing Outlet Collections. 


New aferwncong Oort Coco 





Poderíamos acessar esta listagem de eventos ( Sent Events) e puxar 
qualquer um dos eventos para uma função de callback que definimos. No 
entanto, não necessitamos de mais nenhuma agora. 





N MANEIRAS: O MESMO RESULTADO 


Essas são só duas das maneiras de trabalhar com o Xcode para criar 
uma GIBAction, e existem outras que veremos. Mesmo que no final 
todas tenham o mesmo resultado, tentaremos mostrar diversas delas para 
que você possa escolher aquela em que sentir mais prática de acordo com 
o que você tem em mãos aberto em sua tela naquele instante - ou de quais 
configurações deseja fazer ao criar uma IBAction ou similares. 











Chegou a hora de ler os dados dos dois campos, Name e Happiness. 
Dentro de nossa função, vamos imprimir os dois, primeiro declarando duas 
Strings e concatenando-as durante a impressão: 


OIBAction func add() 1 
var name : String = "guilherme?s sundubu"; 
var happiness : String - "5"; 
println("eaten: N(name) X(happiness)!"); 
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Note que em Swift o ; é opcional, ele só é obrigatório quando desejar 
utilizar duas expressóes na mesma linha, portanto podemos remover os ;: 


OIBAction func add() { 
var name : String - "guilherme?s sundubu" 
var happiness : String = "5" 
println("eaten: N(name) N(happiness)!") 


Como já estamos inicializando as variáveis no mesmo instante de suas 
declarações, não precisamos declarar seus tipos, elas têm seus tipos inferidos 
direto na inicialização: 


OIBAction func add() { 
var name - "guilherme?s sundubu" 
var happiness - "5" 
println("eaten: N(name) N(happiness)!") 


Além disso, tanto o nome quanto a felicidade nào mudam de valor, de 
modo que podemos declará-las como referéncias imutáveis, ou seja, constan- 
tes. Podemos fazer isso utilizando a palavra reservada let: 


OIBAction func add() { 
let name - "guilherme?s sundubu" 
let happiness - "5" 
println("eaten: N(name) N(happiness)!") 


2.6 CONECTANDO VARIÁVEIS MEMBRO À SUA PARTE 
VISUAL: GIBOUTLET 


Voltando ao código, não queremos valores arbitrários como "guilhermes sun- 
dubu" ou “5”. Desejamos ler o valor de nossos campos de texto. Como fazer 
isso? Da mesma maneira como conectamos uma funcáo a um elemento vi- 
sual, podemos conectar um elemento visual por inteiro a uma variável. No 
nosso caso, queremos representar um UITextField, portanto nossa variá- 
vel será deste tipo: 
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var nameField: UlTextField 
var happinessField: UlTextField 


Cuidado, pois não declaramos essas variáveis como locais à função! As- 
sim como a função, elas são membros de nossa classe, membros de nosso 


ViewController: 


import UIKit 
class ViewController: UlViewController { 


var nameField: UITextField 
var happinessField: UITextField 


@IBAction func add() { 


let name - "guilherme?s sundubu" 


let happiness - "5" 
println("eaten: N(name) N(happiness)!") 


Mas, na hora em que a adicionamos, a IDE indica erros. Ao clicarmos no 
ícone vermelho que representa um erro na barra à esquerda, vemos a mensa- 


gem de quea Class ViewController has no initializers: 


eoo ~. ViewController swift 
DE Assam | ga Phones Running eggplant-brownie on IPhone $ 9: 
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Casa do Código 





Isso ocorre pois toda variável membro deve ser inicializada ou declarada 


como opcional. 








ERROS DE COMPILAÇÃO 


Infelizmente o parser e compilador da linguagem Swift pode ser per- 
der em seu código com uma certa facilidade. Caso o Xcode não mostre 
o erro mencionado, tente rodar sua aplicação, nesse instante é certo que 
ele tentará compilar seu código e encontrará o erro. Sempre que era para 
ter um erro de compilação e o Xcode não mostrar para você, tente rodar 
sua aplicação, forçando a compilação. 





Colocamos o ! ao final da declaração para indicar que ela é opcional para 


a criação deum ViewController. 


var nameField: UlTextField! 
var happinessField: UlTextField! 








CUIDADO: OPCIONAIS COM ! 


Cuidado: uma variável declarada opcional com ! que tenha valor 
nulo e seja acessada pode crashear sua aplicação. Veremos outra maneira 
de declarar e acessar variáveis opcionais, além de vantagens e desvanta- 
gens de cada abordagem no decorrer do conteúdo aqui apresentado. 

Não desejamos programar de qualquer jeito e uma das principais boas 
práticas que veremos diversas vezes estará ligada ao uso adequado de va- 
lores opcionais para evitar erros em nossa aplicação. Não pretendemos 
ensinar de qualquer maneira a utilização de ! nem mesmo incentivar o 
uso indiscriminado do mesmo: seremos bem críticos em relação a ele. 
Por enquanto, adotamos o ! na declaração de nossas variáveis para in- 
dicar ao compilador que a variável é opcional mas nós, desenvolvedores, 
sabemos que ela tem valor (e corremos o risco). 











Da mesma maneira como fizemos com nossa ação, devemos anotar nos- 


sas variáveis. Desta vez, nós as anotamos como @IBOutlets e puxamos a 
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bola vazia ao lado da variável name para nosso campo name na interface 


visual: 
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button grenier 





+ 088 ae: - na up: 


Agora, dentro de nossa função de adicionar uma nova refeição, podemos 
pegar o valor de nossos campos. Em cada um deles, utilizamos a propriedade 
text para extrair seus valores: 


import UIKit 
class ViewController: UlViewController 1 


OIBOutlet var nameField: UITextField! 
CIBOutlet var happinessField: UITextField! 


OIBAction func add() { 
let name - nameField.text 
let happiness - happinessField.text 
println("eaten: N(name) N(happiness)!") 
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Ao clicarmos no botão, vemos o resultado no log com os valores que en- 
tramos nos campos. É o que esperávamos! 
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ACÓES CONECTADAS 


Preste sempre atenção ao desenho dos círculos (as bolinhas) ao lado 
de suas ações. Se um círculo estiver preenchido, ele está conectado a algo. 
Se ele estiver vazio, então está desconectado. Se você renomear o método, 
ele se desconectará pois a conexão é feita via o nome do método. Tome 
cuidado sempre que renomear métodos ou atributos anotados. Tenha 
cuidado também em copiar/colar componentes conectados pois a cone- 
xão também é copiada. Caso seja necessário renomear ou copiar/colar 
um item já conectado, lembre-se de desfazer a conexão efetuada anteri- 


ormente, pois o Xcode acusará um erro: 


View Controller 
Triggered Segues 
manual 
Outlets 
happinessField x 1forsad, 5 for amazing 
nameField x dani's cheesecake, guilherme's sundubu etc 
searchDisplayController 
view View 
Presenting Segues 
relationship 
show 
show detail 
present modally 
popover presentation 
embed 
push (deprecated) 
modal (deprecated) 
custom 
Referencing Outlets 


New Referencing Outlet 

Referencing Outlet Collections 

New Referencing Outlet Collection 

Received Actions 

add x add 


Touch Up Inside 
adicionar The 'add' action of 'ViewController' is not defined. 


Se você rodar a aplicação com uma conexão mal feita, ela pode desde 
(sem querer) funcionar de maneira inesperada como parar. 





oee9 O 


* O O O00000000 
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2.7 Resumo Casa do Código 








NOME DOS CAMPOS 


Existe um padráo comum em desenvolvimento de interfaces de pro- 
gramas desktop baseado na notacáo húngara, onde tentamos indicar no 
nome da variável qual o seu tipo. 

Um combo box para representar o género de um usuário poderia se 
chamar cbGender, enquanto o campo de texto com seu nome seria o 
txtName. Esse padráo náo é seguido como regra geral no desenvolvi- 
mento de aplicações iOS. Outro padrão comum é utilizar field como 
prefixo ou sufixo. Aqui adotamos field como sufixo, assim como é 
feito no nome das classes ( Controller, Delegate etc) nas APIs do 
iOS. 











2.7 RESUMO 


Somos capazes de criar uma interface mínima com nosso usuário, além de 
receber valores e ter métodos invocados quando determinados eventos ocor- 
rem. 

Aprendemos um pouco da linguagem Swift: sabemos criar uma classe, 
variáveis locais e membros, além da definicáo de constantes. Vimos também 
que alinguagem é type safe inclusive em relacáo à náo inicializacáo de 
variáveis: fomos obrigados a utilizar o ! para dizer que sabemos que essa 
variável é opcional e terá um valor válido em execução. 

Aprendemos também a usar nossa IDE para navegar no projeto e cons- 
truir nossa interface, que foi rodada em um simulador do iPhone. Somos 
capazes de testá-la em diversas versóes de iPhones. 

Durante esse caminho todo conseguimos perceber algumas boas práticas 
de desenvolvimento de software em geral, tanto em relação à utilização de 
constantes quando cabível quanto em relação à interface que oferecemos para 
nosso usuário final. 

Nosso próximo passo é aprender mais dessa linguagem para podermos 
modelar nossas classes que representarão uma refeição ( Meal) e um item 
contido nela ( Item). 
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CAPÍTULO 3 


Swift: a linguagem 


Veremos aqui a base da linguagem que será suficiente para criarmos uma apli- 
cação utilizando diversas boas práticas de programação. Não nos viciaremos 
com o uso desnecessário de variáveis globais e outras más práticas que dificul- 
tam a manutencáo do código ao longo prazo. Para isso utilizaremos diversos 
padrões, além do básico de Orientação a Objetos. 

Nosso foco não é ensinar Orientação a Objetos (OO) avançada aqui, mas 
quanto maior sua base em boas práticas de OO de outras linguagens, melhor 
poderá tomar cuidados importantes em Swift. Diversos deles serão citados 
por aqui. 


3.1 BRINCANDO NO PLAYGROUND 


Criamos primeiro um playground, onde poderemos testar diversas funciona- 
lidades. Na janela do Xcode, Command+N e escolhemos iOS, playground, 


34. Brincando no playground Casa do Código 





deixamos o nome MyPlayground.playground e temos o playground 
pronto! Na esquerda, escrevemos o código, na direita vemos o seu resultado: 


eoo | MyPlayground.playground ue 





m | 4 | m MyPlayground.playground > No Selection 
// Playground - noun: a place where people can 
play 


import Cocoa 


var str - "Hello, playground" Hello, playground 


Note que o playground nào faz parte do seu projeto em si, somente deve 
ser usado para testes rápidos, que é o nosso caso. Vamos utilizá-lo para en- 
tendermos melhor diversos conceitos da linguagem. 

Primeiro, testaremos algumas coisas que já conhecemos. Removemos o 
código do playground atual e criamos uma String imprimindo-a: 


var name = "Guilherme" 
name = "Guilherme Silveira" 
println (name) 


Na direita, temos os resultados de nossas execuções: 
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BE 4 > | eggplant-brownie > [W eggplant-brownie > È MyPlayground. 


var name - "Guilherme" “Guilherme” 
name = "Guilherme Silveira" “Guilherme Silveira” 
print in(name) “Guilherme Silveira” 


Da mesma forma como usamos um editor com assistência para arras- 
tar nossos IBOutlets e IBAction, o playground oferece um assistente 
chamado Timeline. Ele pode ser ativado clicando naquele ícone que usa- 
mos para abrir o editor para arrastar as ações ou no menu View, submenu 





Assistant Editor, opção Show Assistant Editor. Na saída dele, 





vemos o resultado de nossas informações de log: 


BE <a >| [Be.e>[7]> È MyPlayground.playground > No Selection B8 | 4 > |O È m.o + x 


var name = "Guilherme" “Guilherme” 
name = "Guilherme Silveira" “Guilherme Silveira” y Console Output 
printin(name)| Guilherme Silveira Guilherme Silveira 


(no results) 


Como vimos antes, em Swift, o ; no fim de uma instrução é opcional, ele 
só é obrigatório quando duas instruções ficam na mesma linha: 


var name = "Guilherme" 
name = "Guilherme Silveira"; println (name) 


Podemos também criar uma constante. Se tentarmos atribuir um novo 


valor à constante, o compilador mostra uma mensagem de erro: 


let project = "Eggplant Brownie" 
project = "Zucchini Muffin" 
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// Playground — noun: a place where people 


let project = "Eggplant Brownie" Eggplant 
O: project = "Zucchini Muffin" “O Cannot assign to "let' value 'project 





BOA PRÁTICA: CONSTANTES 


Utilizar constantes (em Swift, let), quando cabível, é considerado 
uma boa prática em programacáo em geral, ao invés de referéncias mu- 
táveis (em Swift, var). Isso pois, uma vez definida, a variável continua 
com o mesmo valor até “deixar de existir” (oficialmente, ser desreferen- 
ciada). Náo existe nenhuma complexidade ligada á troca de referéncias. 











Como vimos, uma constante define uma conexáo imutável entre seu 
nome e o valor passado durante sua inicialização. Não há preocupação de 
ela ter sido alterada antes de acessá-la em qualquer ponto de seu programa. 

E se desejamos comentar alguma linha no nosso código? O comentário 
tradicional é o // que comenta o resto da linha: 


// too complex code need a one line comment 
let project - "too complex, so it requires a comment" 


Outra opção seria usar o. /* ... */ , que permite o comentário em 
diversas linhas. 


/* 
nuclear devices code might need 
multiple line comments 


*/ 
let device = "nuclear" 

O /* ... x/ pode ser usado também para comentar algo no meio da 
linha: 
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let universe /* needs a middle comment to explain */ = "big" 





CODE SMELL: COMENTÁRIOS 


Em geral, quando precisamos comentar algo, é sinal de que o código 
está complexo e o próximo desenvolvedor sofrerá para entendé-lo. Se o 
desenvolvedor sofre, a chance de surgirem novos erros por uma mudança 
indevida é grande. Isto é, a necessidade do comentário está indicando 
que o código que escrevemos está declarado de determinada maneira que 
não parece ser fácil de manter. 

Sendo assim, esse code smell pode ser usado como um sinal para 
alterarmos nosso código. Temos como arsenal de refatoração diversas 
ações, como extrair variáveis, métodos, renomear ambos etc. Deixar 
nosso código claro o suficiente para o próximo desenvolvedor pode di- 
minuir a chance de futuros bugs serem introduzidos em nossa aplicação. 











Vamos aplicar a declaração de variáveis ao nosso domínio, de refeições e 
itens. Podemos apagar todo o nosso playground. 

Primeiro, precisaremos representar uma refeição. Em inglês, uma refei- 
ção será representada por um mea1, e ela tem tanto o nome que demos para 
a refeição daquele dia ( String), quanto nossa nota, que será representada 
com um nümero inteiro ( Int): 


let name - "Dani?s paradise" 
let happiness = 5 // Int 


Representaremos uma refeição por um conjunto de alimentos, como uma 
sopa de abóbora ou seu brownie de berinjela, com poucas calorias. Para re- 
presentar as calorias, usaremos um nümero decimal, um nümero com ponto 
flutuante: 


let name - "eggplant brownie" 
let calories = 50.5 // Double 
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Mas repare que o código nào compilará se vocé mantiver o exemplo ante- 
rior: duas variáveis náo podem ter o mesmo nome ( name) no mesmo escopo. 
Neste capítulo, antes de cada exemplo, lembre-se de apagar ou comentar o có- 
digo anterior antes de continuar. 

Além desses tipos, será recorrente o uso de variáveis do tipo true ou 
false, os tipos booleanos: 


let eggplantBrownieIsVeggie - true 
let eggplantBrownieTastesAsChocolate - false 


Variáveis booleanas em Swift são do tipo Boo1, portanto uma declaração 
com tipagem explícita seria: 


let eggplantBrownieIsVeggie:Bool - true 
let eggplantBrownieTastesAsChocolate:Bool - false 





TIPOS BÁSICOS 


Existem, claro, diversos outros tipos para utilizarmos, mas o básico 
que cobre a maior parte dos casos são os apresentados até aqui: Double, 
Bool, Inte String. Além desses, já vimos e continuaremos vendo 
outras classes que seráo utilizadas em nosso projeto. 

Há desde tipos numéricos só de valores positivos até classes que 
permitem o acesso ao disco. Você pode consultar a documentação da 
Apple para conhecer mais sobre as classes que deseja em http://bit.ly/ 
swift-linguagem-guiadereferencia 











Podemos definir funções novas, com o uso de func, e invocá-las: 


func helloCalories() 1 
println("hello calories!") 


helloCalories() 


Note que o resultado aparece como a impressáo da linha onde fizemos 
O println, e não da linha onde invocamos nosso método. Isso porque o 


44 


Casa do Código Capítulo 3. Swift: a linguagem 





playground está querendo nos mostrar o que aconteceu com cada linha de 
código quando elas foram executadas. 


E | 4 »|[5» » È MyPlayground.playground > FA helloCaloriesQ 


func helloCalories() 1 
println("hello calories!") "hello calories!" 


helloCalories() 


Vamos tentar invocar duas vezes o mesmo método e imprimir outro valor 
no meio: 


func helloCalories() { 
println("hello calories!") 


helloCalories() 
println("oi tudo bem") 
helloCalories() 


Observe que, no resultado que temos agora, essa linha foi executada duas 
vezes. 
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mia >| D) » È MyPlayground.playground » EZ helloCaloriesQ 


func helloCalories() { 


println("hello calories!") (2 times) 
) 
helloCalories() 
println("oi tudo bem") “oi tudo bem” 


helloCalories() 


Por mais que essa visualização nos ajude bastante para entender o resul- 
tado de execução de cada linha isoladamente, talvez seja interessante ver o 
resultado à medida que o código foi executado, ou seja, a saída que foi jo- 
gada com println à medida que o tempo foi passando, uma timeline. É 
exatamente isso que o assistente Timeline que vimos anteriormente faz. 

Ao exibi-lo, temos o resultado em ordem do Timeline. Se seu Xcode 
náo mostrá-lo no modo assistente, clique onde está escrito Timeline como 
na imagem a seguir e selecione-o: 


$99 Dou Ansio emas estar teres | Dus eggpisetibroenie Succeeded | — [T] Mamas > 


Dna so Hom « TEN nie ~ O n ener m ne 
dp Tutte a import UIKit Ti unt Tn 
Twaa OS BOCA! 
10 tvi trema func helloCalories() ( cr: tus | favent Vero 
+ ApsOvagate sut printin("hello (2 times) presta Mee Deina But Pays E) 
demo y calories") Mito calories! Lasten Molas to Gere B 
[Ed A Mera arguet i 
helloCalories() fa ras 
| amener printla("oi tudo bes")  'oitudobem Decore carta pace 
HEAT. hellaCalories(] or ns 
— 
[ES 
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BUG DO ASSISTANT 


Caso o assistente náo mostre um console vazio, nem mostre o resul- 
tado das invocações, você pode voltar ao modo normal e novamente ao 
assistente. Em algumas versóes, o Xcode possui um bug que faz com que, 
na primeira vez que mudamos para o Timeline, ele mostre o console 


vazio. 











Também podemos clicar no ícone circular à esquerda do playground, que 


se assemelha ao símbolo de + quando passamos o mouse por cima dele: 


B | «4 >| B>? ' E MyPlayground.playground > No Selection 


func helloCalories() 1 
println("hello calories!") (2 times) 


helloCalories() 


println("oi tudo bem") “oi tudo bem" Do 


helloCalories() 





O resultado é que logo abaixo do console conseguimos ver a saída so- 


mente desta linha: 
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|< >| >> È MyPlayground.playground > No Selection [EE | 4 >O BEM) + x 


func helloCalories() 1 i 
println("hello calories!") (2 times) > <  printin('h...calories!") 


hello calories! 


helloCalories() 
println("oi tudo bem") “oi tudo bem" s 


helloCalories() hello calories! 


printin("oi tudo bem" 


oi tudo bem 


As funções podem receber parámetros, como o nome e o número de ca- 
lorias ao adicionar um novo item a uma refeicáo. Quando os recebemos, de- 
vemos dizer quais os tipos desses parámetros: 


func add(name: String, calories: Double) ( 
println("adding N(name) N(calories)") 


add("Eggplant", 50.5) 


3.2 ARRAYS 


Até agora estamos trabalhando com tudo em uma única unidade. Não pode- 
mos ter duas variáveis com o mesmo nome no mesmo escopo. Como acumu- 
lar diversos produtos? Diversos elementos do mesmo tipo? Queremos criar 
um array. Podemos criar um array de calorias, por exemplo: 


let calories = [50.5, 100, 300, 500] 


Poderíamos opcionalmente declarar o tipo do array explicitamente: 


let calories:Array<Int> = [ 50.5, 100, 300, 500] 


Opa, não compila. Claro, um dos valores é double, portanto é um array 
de doubles: 
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let calories:Array<Double> = [ 50.5, 100, 300, 500] 


Somente se o array fosse vazio seria interessante indicar o tipo de array 
que queremos: 


let items:Array<Double> = [ ] // Doubles 


Agora que tenho um array de calorias, com tipagem implícita, gostaria 
de passar por todos os seus itens para somá-los. Como fazer isso? Fazemos 
um for de o até 4 (o número de elementos, exclusive): 


let calories = [ 50.5, 100, 300, 500] 
for var i = 0; i < 4; i++ { 


println(calories[i]) 


Podemos utilizar a propriedade count de um Array para fazer esse 
laço: 


let calories = [ 50.5, 100, 300, 500] 
for var i = 0; i < calories.count; i++ { 
println(calories[i]) 


Quando nosso for é específico de somar um em um o número do índice, 
podemos usar o atalho que passa entre o o e o 3, inclusive: 


let calories = [ 50.5, 100, 300, 500] 
for i in 0...3. f 
println(calories[i]) 


Se utilizarmos calories.count, temos que tomar cuidado. Esse va- 
lor será 4 e teremos um erro, afinal estaríamos iterando da posição o a 4 (5 
elementos). Queremos, portanto, calories.count - 1: 


let calories - [ 50.5, 100, 300, 500] 
for i in O...(calories.count - 1) { 
println(calories[i]) 
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Que código feio! Mesmo extraindo uma variável ainda nào parece ser um 
código ideal em nossa situacáo: 


let calories = [ 50.5, 100, 300, 500] 

let total - calories.count - 1 

for i in O...total { 
println(calories[i]) 


Quando desejamos passar por todos os elementos de um Array, pode- 
mos utilizar o for in: 


let calories = [ 50.5, 100, 300, 500] 
for c in calories 1 
printin(c) 


Por fim, uma função pode retornar algo, como o total de calorias contidas 
em um Array de calorias: 


func allCalories(calories: Array<Double>) { 
var total - O 
for c in calories 1 
total += c 
J 


return total 


allCalories([ 10.5, 100, 300, 500]) 


Mas precisamos dizer qual o retorno da funcáo. Como ela devolve um 
Double,será -» Double: 


func allCalories(calories: Array<Double>) -> Double 1 
var total - O 
for c in calories 1 
total += c 


} 


return total 
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allCalories([ 10.5, 100, 300, 500]) 


Contudo, ainda tem algo de errado. O que nào compila nesse código? A 
variável total é implicitamente um Int e somos avisados disso. Mudamos 
então para um Double: 


func allCalories(calories: Array<Double>) -> Double 1 
var total = 0.0 
for c in calories { 
total += c 


} 


return total 


allCalories([ 10.5, 100, 300, 500]) 


Ou definimos a tipagem explícita: 


func allCalories(calories: Array<Double>) -> Double { 
var total:Double = 0 
for c in calories { 
total += c 


} 


return total 


allCalories([ 10.5, 100, 300, 500]) 


Por fim, quando invocamos uma função que retorna algo, podemos uti- 
lizar seu retorno diretamente ou aplicá-lo a uma variável: 


func allCalories(calories: Array<Double>) -> Double { 
var total:Double = 0 
for c in calories { 
total += c 


} 


return total 
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let totalCalories = allCalories([ 10.5, 100, 300, 5001) 
println(totalCalories) 


3.3 BOA PRÁTICA: CUIDADO COM INFERÉNCIA DE TI- 
POS 


É preciso tomar cuidado com a inferéncia automática de tipos. Um problema 
clássico ocorre quando dividimos dois Ints e o resultado final é um Int 
sem percebermos, achando que estamos dividindo Doubles. Preste muita 
atencáo ao usar a inferéncia, ela ajuda a digitar menos, mas exige mais na 
hora de utilizá-la. 


var values - [ 1, 2] 


var total - O 
for v in values { 
total += v 
} 
println(total / values.count) // 1? 1.5? 


Tome muito cuidado com tipos implícitos. Digitar menos é bom. Mas o 
mais importante é que nosso programa funcione. 

Parece ser por esse motivo que Swift reforça o tipo de retorno ao invocar 
um método. Enquanto em Scala, uma linguagem muito parecida em diversos 
pontos com Swift, o retorno pode ser implícito, em Swift ele não pode. O 
código a seguir não compila pois a função não indicou qual tipo ela retorna. 
Ela poderia inferir Int: 


func number() { 
return 15 // compilation error 


var values - [ number(), number()] 


Como a linguagem náo infere, precisamos declarar o tipo de retorno. 


func number() -> Int ( 
return 15 
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var values - [ number(), number()] 


3.4 RESUMO 


Neste capítulo, vimos como criar um playground e utilizá-lo para testar ca- 
racterísticas da linguagem ou executar pequenos trechos de código Swift. 
Vimos como a linguagem cuida da declaração e inicialização de variáveis, 
como ela se vira com a tipagem implícita e o cuidado que devemos tomar com 
ela. 
Criamos funções que recebem argumentos, que devolvem valores e traba- 
lhamos com Int, Double, Boole Strings. Fizemos algumas operações 





aritméticas e utilizamos o laço do tipo for para iterar por elementos. 

Apesar de não termos utilizado aqui, o if, while e outros, eles se as- 
semelham em muito a outras linguagens como Java, C e C4. Alguns deles 
veremos neste material, outros são de simples aprendizado e de fácil consulta 
no guia de referência da linguagem. 
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CAPÍTULO 4 


Swift: mapeando nossos modelos 
e introdução à Orientação a 
Objetos 


4.1 BOA PRÁTICA: ORGANIZANDO OS DADOS 


Toda vez que tenho uma refeição, devo trabalhar com duas variáveis (nome, 
felicidade) e um array? Se uma função deseja passar uma refeição para outra 
função, deve passar esses três argumentos? Toda vez? 

E toda função que depende de uma refeição deve ficar jogada pelos cantos 
do nosso programa? O cálculo de calorias total, o cálculo de felicidade por 
caloria? Cada coisa jogada em um canto? 


Orientação a Objetos apresenta uma solução para esses problemas ao 
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agrupar os dados e comportamentos ligados em um ünico lugar, uma ünica 
classe. 

Swift oferece também características de uma linguagem orientada a obje- 
tos. Para agruparmos todos os atributos que uma refeição possui, junto com 
os comportamentos que ela pode ter, criamos uma classe. A classe é a abstra- 
cáo de uma refeição. Atributos da refeição seriam o nome, a felicidade e seus 
itens. Já comportamentos (métodos) da classe seriam o cálculo de calorias 
totais, de felicidade por caloria etc. 


Vamos limpar todo nosso playground e colocar a classe Mea1: 


class Meal { 





BOA PRÁTICA: PARA SABER MAIS DE ORIENTAÇÃO A OBJETOS 


Você pode conhecer mais de Orientação a Objetos estudando o con- 
ceito com a apostila da Caelum, disponível online em seu site. 

O blog da Caelum também oferece diversos artigos sobre o assunto, 
como o artigo que mostra como evitar sequências de ifs em Orientação 
a Objetos: http://bit.ly/como-nao-aprender-oo 











Portanto, no nosso caso, toda refeicáo terá um nome e um nível de felici- 
dade, os quais chamamos em Swift de propriedades armazenadas: 


class Meal { 
var name - "Eggplant Brownie" 
var happiness - 5 


Podemos agora criar uma refeição, acessar e alterar seus valores. Para 
criá-la, usamos seu construtor, seu inicializador, que se assemelha à chamada 
de uma função (ou método) com o nome igual ao do tipo da classe: 


let brownie = Meal() 
println(brownie.name) 
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println(brownie.happiness) 


brownie.happiness - 3 
println(brownie.happiness) 


class Meal 1 
var name = "Eggplant Brownie" 
var happiness - 5 


let brownie = Meal() [name "Eggplant Brownie” happin 
println(brownie.name) "Eggplant Brownie" 
println(brownie.happiness) je 

brownie.happiness - 3 (name "Eggplant Brownie" happin 
println(brownie.happiness) Em 


O que estamos fazendo aqui é definindo uma variável chamada brownie 
que referencia um objeto. Ele “aponta”, referencia o objeto que está criado na 
memória. 

Note que, apesar de brownie ser uma constante, podemos trocar os va- 
lores dentro do objeto. Como os valores foram declarados como vars, eles 
puderam ser alterados; é a referência ao objeto que não pode ser trocada. O 
código a seguir tenta alterar nossa referência de uma constante, apontando 
agora para uma nova refeição, e falha: 


let brownie = Meal() 
println(brownie.name) 
println(brownie.happiness) 


brownie.happiness - 3 
println(brownie.happiness) 


brownie = Meal() // error! 


Nesse caso, o que fizemos foi pegar aquela variável que referencia um ob- 
jeto, e fazê-la passar a referenciar (apontar) para outro objeto. Agora ninguém 
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mais referencia o primeiro objeto que criamos. 

Mas, claro, nem toda refeição será um brownie de berinjela. Não parece 
fazer sentido que, toda vez que criarmos um objeto do tipo Mea1, ele ve- 
nha automaticamente preenchido como tal brownie. Vamos remover o valor 
inicial e verificar o que acontece... temos trés erros em nossa classe! 


class Meal 1 
var name 
var happiness 


(A 


Para vermos os erros que aconteceram, podemos clicar na exclamação 
vermelha que fica á esquerda da linha que ocorreu. A linha inteira ficará ver- 
melha: 





Dois destes erros sáo fáceis de resolver: antes o compilador sabia o tipo 
das variáveis, pois inferia os mesmos através de suas inicializações, então adi- 
cionamos as tipagens explícitas: 


class Meal { 
var name: String 
var happiness: Int 


Ficamos agora com um único erro, o compilador diz que a classe Meal 
náo possui um inicializador. O que está acontecendo? Lembre-se que, em 
Swift, a nào existéncia de valor (em geral, o nu11 em outras linguagens) é 
um caso importante o suficiente para ter que ser declarado por explícito. Não 
queremos erros do tipo do acesso a null em tempo de execução, por isso a 


58 


Casa do Código Capítulo 4. Swift: mapeando nossos modelos e introdução à Orientação... 





linguagem coloca barreiras para evitar a existéncia deles. Se o desenvolvedor 
desejar a existência de um nu11, ele deve ser responsável por marcar aquele 
campo como tal, um campo que é opcional, que pode ter um valor nulo. 


class Meal 1 
var name: String? 
var happiness: Int? 


Repare que a impressáo de um nome e do nível de felicidade mostra agora 
os valores nil (o null em Swift): 


class Meal 1 
var name: String? 
var happiness: Int? 


let brownie = Meal() 
println(brownie.name) 
println(brownie.happiness) 


1 class Meal { 
) var name: String? 
var happiness: Int? 
) 
ó let brownie = Meal() ínil nil} 
7 printin(brownie.name) "nil" 
a  println(brownie.happiness) "nil" 





E se colocarmos um valor dentro de nossa refeição, como fica a saída? 


let brownie = Meal() 
brownie.name = "Eggplant brownie" 


brownie.happiness = 3 


println(brownie.name) 
println(brownie.happiness) 
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class Meal 1 
var name: String? 
var happiness: Int? 


let brownie = Meal() [nil nil} 

brownie.name = "Eggplant brownie" Some "Eggplant brownie”) nil} 

brownie.happiness = 3 Some "Eggplant brownie”) (Sor 
println(brownie.name) "Optional("Eggplant brownie") 

println(brownie.happiness)| "Optional(3) 


Ele deixou claro que o que temos agora náo é mais uma String ou um 
Int, mas sim um Optional[String] ouum Optional[Int]. O que 
o compilador faz é: se vocé deseja uma variável com valor opcional, marque 
com o ?. Nesse caso, seu valor inicial é ni1 e, ao colocar algo lá dentro, ele 
passa a valer Optional (valor colocado). 





Observe que podemos deixar explícito o uso do Optional ao atribuir 
valor a uma variável opcional, como no código a seguir: 


var name: String? 
name = Optional("Zucchini muffin") 


Mas podemos deixar implícita a transformação de um valor para seu tipo 
Optional, como em: 


var name: String? 
name = "Zucchini muffin" 


As duas abordagens produzem o mesmo resultado para o compilador, 
uma vez que, a partir do momento que a variável for declarada com St ring?, 
ela será tratada dessa forma em ambos os casos. 

Temos algo de estranho ainda: não desejamos imprimir 


Optional ("Zucchini muffin'"), mas sim somente o nome, a String. 


var name: String? 
name = "Zucchini muffin" 
println (name) 
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Pior ainda, se tentarmos imprimir o tamanho de nossa St ring usando a 





função countElements, percebemos que para uma declaração normal, ela 
funciona: 


var name = "brownie" 
println(countElements(name)) // 7 


Mas não funciona para o Optional, afinal o método recebe String,e 
náo String?: 


var name:String? 

name = "brownie" 

println(countElements(name)) // error: type ?String?” 
// does not conform to protocol 
// ? CollectionType” 


Acontece que um Optional náo é do tipo que queremos, desejamos ex- 
trair o que está lá dentro, tanto na hora da impressáo quanto no momento de 
usar o conteúdo de nossa St ring?. Mas o compilador não é bobo, ele quer 
nos ajudar e dizer: desenvolvedor, ao tentar usar essa variável, vocé tem na 
verdade um Optional, tem um risco aí, talvez seja algo nil. Tem certeza? 
Desenvolvedor, se vocé acessá-la sem verificar se é válida, é capaz de seu pro- 
grama parar completamente - pior ainda, ele com certeza vai parar caso seja 
nile vocé chame um método dele. 

Vamos dizer ao compilador que sabemos o que estamos fazendo. Nós 
sabemos que o que está lá dentro é algo nào nulo, e que assumimos o risco 
utilizando o caractere !: 


var name:String? 
name = "brownie" 
println(countElements(name!)) // 7 


Perfeito, mas isso é arriscado, olhe o que acontece caso seja nil, o caso 
que o compilador tentou a todo custo evitar: 


var name:String? 
println(countElements(name!)) // fatal error 
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CUIDADO COM BUGS DO COMPILADOR DO XCODE 


Como Swift é uma linguagem nova, o compilador utilizado pelo 
Xcode pode se confundir com algumas coisas. Nos exemplos feitos a 
partir deste capítulo, tome cuidado: caso a mensagem de erro apareça 
em uma linha diferente daquela esperada, teste o caso que está interes- 
sado isoladamente. Fazer cada um dos testes de maneira isolada evita 
deixar o compilador perdido. No playground, isso ocorre mais frequen- 
temente, uma vez que ele utiliza informações de debug para imprimir os 
resultados do lado direito de nossa IDE. 











Não queremos que isso aconteça, portanto o mais comum é verificar se o 


campo é náo nulo, e só entáo utilizá-lo: 


if (name !- nil) ( 
println(countElements(name!)) // 7 
} else { 
println("empty") 


} 

No Swift, os parênteses do if (e dos laços) é opcional, portanto pode- 
mos fazer: 
if name != nil { 


println(countElements(name!)) // 7 
} else { 
println("empty") 


Como estamos utilizando nossa String mais de uma vez dentro do có- 
digo, podemos querer fugir do uso do ! ao fazer o. if e já declarar uma 
variável com o valor real ao mesmo tempo: 


var name: String? 

if let n = name ( 
println(countElements(n)) // 7 

) else { 
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println("empty") 


Mas sejamos sinceros. Nesse caso, nós temos certeza de que existe um va- 
lor na nossa String e, apesar de a declararmos como opcional, gostaríamos 
de dizer ao compilador que temos certeza de que ela tem um valor válido, 
usando o ! na declaração da variável: 


var name:String! 
name = "Eggplant Brownie" 


println(countElements(name)) // 7 


Lembre-se de tomar muito cuidado toda vez que usar o !, seja para aces- 
sar o valor de uma variável opcional, seja ao declarar uma variável opcional 
quando vocé tem certeza de que ela será inicializada. 

Se tentássemos usá-lo sem o valor inicializado, a responsabilidade seria 
do programador e o erro seria fatal: 


var name:String! 
println(countElements(name)) // fatal error 


E toda essa história de uma linguagem tratar um valor opcional ( 
Optional) com tanto carinho, como fica nos casos de invocação de métodos 
que retornam valores opcionais? Vamos definir uma String com o valor 5 


e transformá-la em um Int, qual o tipo retornado? 


let happiness = "5" 
println(happiness.toInt()) 


O resultado é um Optional<Int>, afinal pode ser que dê um erro 
e o valor aí dentro de nossa String não seja um número. Repare que o 
Optional pode ser usado como alternativa no retorno de um método para 
dizer que o processo foi um sucesso ou não. É um tradeoff que os implemen- 
tadores da linguagem escolheram na hora de implementar o método toInt 
da String. 
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4.2 BOA PRÁTICA: GOOD CITIZEN (EVITE NULOS) E O 
INIT 


Sempre que criamos uma refeição, precisamos de um nome e de um nível 
de felicidade. Essas não são características opcionais. Diversas linguagens 
orientadas a objeto favorecem e pregam a “boa prática” (ironia intencional) 
de deixar tudo mutável através de getters e setters, propriedades ou qualquer 
outro nome dado a uma variável membro (propriedade) que é mutável e ini- 
cializada com zero ou nulo. 

O perigo de uma variável não inicializada é simples: você tem um objeto 
que pode não estar preparado para ter um método chamado. O padrão Good 
Citizen diz que todo objeto, assim que criado, deve estar pronto para ter 
todos os seus métodos executados. Não existe “não invoque enquanto” ou 
“invoque somente após” Com isso evitamos, por exemplo, os diversos null 
pointers ou fatal errors que podemos tomar em nossas aplicações: 
todos os valores estão preenchidos, nenhum está vazio! 

Swift reforça isso com a utilização de variáveis opcionais explícitas: se 
você quiser que ela seja opcional, deve explicitar, e deve também, quando 
acessá-la, explicitar que sabe o que está fazendo. São dois passos que um de- 
senvolvedor precisa tomar antes de fazer uma bobagem. 





CODE SMELL: COMO NÃO APRENDER ORIENTAÇÃO A OBJETOS: 
GETTERS E SETTERS 


O blog da Caelum possui um post de Paulo Silveira sobre como não 
aprender Orientação a Objetos, e os problemas da utilização de getters e 
setters: 

http://bit.ly/encapsulamentoGetterSetter 











4.3 Nosso GOOD CITIZEN 


Devemos obrigar todos os programadores que desejam instanciar Meal a 
passar os dois argumentos. É o que definimos no nosso inicializador, o cons- 
trutor, e alteramos nosso código para garantir isso, não queremos opcionais! 
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class Meal 1 
var name:String? 
var happiness:Int? 
init(name: String, happiness: Int) { 


h 


Podemos instanciar e mostrar que nosso Meal sempre tem valor, e nunca 
aceita nil. Podemos ser felizes com um Mea1, que ele nunca vai dar um 


fatal error (ouequivalente a um Null pointer): 


let brownie - Meal("Eggplant brownie", 5) 


println(brownie.name) 
println(brownie.happiness) 


Mas o compilador reclama. Ao inicializarmos um objeto durante a cons- 
trucáo, é obrigatória a passagem do nome dos parámetros, ficando claro o que 
é o qué: 


let brownie - Meal(name: "Eggplant brownie", happiness: 5) 


println(brownie.name) 
println(brownie.happiness) 


Mas se recebemos o nome e a felicidade no construtor, náo precisamos 
dos opcionais: 


class Meal 1 
var name:String 
var happiness:Int 
init(name: String, happiness: Int) { 


F 


Agora o Xcode reclama de que náo inicializamos as variáveis que nào sáo 
opcionais. Desejamos ser um bom cidadão, e, se você possuir uma referén- 
cia para um Meal, pode ter certeza de que tudo que está lá dentro está bem 
configurado, com todos os valores preenchidos. Portanto, em nosso cons- 
trutor, atribuímos os valores dos parámetros para nossas propriedades. Para 
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isso, referenciamos o próprio objeto que está sendo construído (ou que já foi 
construído) através da referéncia self: 


class Meal { 
var name:String 
var happiness:Int 
init(name: String, happiness: Int) { 
self.name - name 
self.happiness - happiness 


Agora sim, nosso código compila e podemos ver que ele já tem valores 
válidos logo em sua inicialização. Podemos também conferir que a execução 
de nosso código náo permite a passagem de nulo: 


let brownie - Meal(name: nil, happiness: 5) // compile error 


Temos nosso Good Citizen, um objeto do qual, quando temos uma 
referéncia, temos certeza de que duas propriedades estáo bem definidas e po- 
demos utilizá-lo. 


Seguindo os mesmos princípios, criamos nosso Item: 


class Item 1 
var name:String 
var calories:Double 
init(name: String, calories: Double) { 
Self.name - name 
self.calories = calories 


class Meal { 
var name:String 
var happiness:Int 
init(name: String, happiness: Int) { 
self.name - name 
self.happiness - happiness 
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Mas queremos que nossa refeição possua diversos itens. Usemos, então, 
um array de itens: 


class Item ( 
var name:String 
var calories:Double 
init (name: String, calories: Double) { 
self .name = name 
self.calories = calories 


class Meal 1 
var name:String 
var happiness:Int 
var items 
init(name: String, happiness: Int) { 
self.name - name 
self.happiness - happiness 


Mas isso nào faz sentido. Queremos que a variável items seja um array 
vazio de itens: 


class Item ( 
var name:String 
var calories:Double 
init (name: String, calories: Double) { 
Self.name - name 
self.calories = calories 


class Meal 1 
var name:String 
var happiness:Int 
var items = Array<Item>() 
init (name: String, happiness: Int) { 
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self .name = name 
self .happiness = happiness 


Além de propriedades e construtores, uma classe pode ter métodos, como 
um que nos ajude a calcular o total de calorias de uma refeição: 


class Item 1 
var name:String 
var calories:Double 
init(name: String, calories: Double) 1 
Self.name - name 
self.calories = calories 


class Meal { 
var name:String 
var happiness:Int 
var items = Array<Item>() 
init(name: String, happiness: Int) { 
self.name = name 
self.happiness - happiness 


func allCalories() -> Double 1 
var total = 0.0 
for i in items { 
total += i.calories 


+ 


return total 


Podemos criar agora um novo item: 


let brownie = Meal (name: "Eggplant brownie", happiness: 5) 
let itemi 
let item2 


ll 


Item(name: "brownie", calories: 115) 


Item(name: "vegan cream", calories: 40) 
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Mas queremos adicioná-los nos itens do brownie. Por isso, chamamos o 


método append: 


let brownie - Meal(name: "Eggplant brownie", happiness: 5) 
let itemi 
let item2 
brownie.items.append(itemi) 


ll 


Item(name: "brownie", calories: 115) 


ll 


Item(name: "vegan cream", calories: 40) 
brownie.items.append(item2) 


Como as variáveis só foram utilizadas para invocar o método append, 
podemos invocá-lo direto, passando como parámetro a referéncia ao objeto 
que acaba de ser inicializado: 


let brownie - Meal(name: "Eggplant brownie", happiness: 5) 
brownie.items.append(Item(name: "brownie", calories: 115)) 
brownie.items.append(Item(name: "vegan cream", calories: 40)) 


println(brownie.allCalories()) 


O resultado do printIn é 155.0, como esperado. 
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BOA PRÁTICA: ENCAPSULAMENTO 


Encapsulamento é esconder como as coisas sáo feitas e permitir 
acesso a uma interface que executa as tarefas pedidas. No nosso caso, 
deixamos de acessar diretamente nossos itens e passamos a perguntar à 
refeicáo qual o total de calorias. 

Encapsular vai muito além de uma mera definição de método, de- 
vemos controlar o escopo de acesso de nossas variáveis, métodos e até 
mesmo classes e pacotes. Veremos outras características ligadas ao en- 
capsulamento ao decorrer do material, e existe uma leitura abrangente 
sobre o tema no blog da Caelum em: 


http://bit.ly/revisitandoOO 


http://bit.ly/encapsulamentoScala 


http://bit.ly/encapsulamentoGetterSetter 


http://bit.ly/encapsulamento EModificadores 











4.4 CODE SMELL (MAL CHEIRO DE CÓDIGO): OPCIO- 
NAL! 


O uso do opcional com o ! no Swift como propriedade indica que uma variá- 
vel terá um valor em tempo de execução mas que o compilador não sabe disso, 
por isso o programador forçou o ! goela abaixo na definição da variável. Mas 
como pode ser que o compilador não saiba que vai ter valor? 

Isso acontece comumente, já que a variável utilizada não será iniciali- 
zada no construtor. Como vimos como Good Citizen, a inicialização no 
construtor evita problemas em tempo de execução; no caso do Swift ele evita 
fatal errors. Portanto, a regra geral é usar sempre valores válidos, evitando 
Optional, e quando usar Optional, tentar usar sempre ? com if para 
garantir o valor; por fim, usar !, nessa ordem de preferência. 
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Veja que os exemplos a seguir todos causam um erro em execucáo e um 
crash de sua aplicação, pois o desenvolvedor cometeu o erro de não checar 
o valor opcional. O código do Meal está protegido, mas antes de invocar o 
construtor, ao extrair o valor da variável name, o desenvolvedor comete o 


erro: 


var name: String? 
let brownie = Meal (name: name!, happiness: 5) 


Ou ainda em: 


var name: String! 
let brownie = Meal (name: name, happiness: 5) 


4.5 RESUMO 


Vimos até aqui como definir uma classe, suas propriedades, métodos, inici- 
alizadores, como instanciá-la e como invocar seus métodos. Vimos também 
boas práticas e cuidados a serem tomados durante a utilização de variáveis 
opcionais e obrigatórias. Por fim, colocamos o método em seu devido lugar: 
um método fica em quem sabe lidar com determinados dados, Orientação a 
Objetos agrupa dados e comportamentos. No próximo capítulo, aplicaremos 
tudo isso ao nosso projeto. 
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CAPÍTULO 5 


Projeto: organizando modelos 
com OO e arquivos em grupos 


Voltando ao código do projeto, podemos criar um novo arquivo que conte- 
nha nossas classes de modelo. Mas os arquivos facilmente ficarão bagunça- 
dos. Para agrupá-los, o Xcode possui uma funcionalidade de criar grupos. 
Clicando no projeto, vamos no menu “File, ‘New Group‘ e chamamos ele de 
models. Nosso projeto fica assim: 


5.1. Boa prática: crie um diretório por grupo Casa do Código 












a B eggplant-brownie - 
= 4 targets, 105 SDK 8.1 
F egaplant-brownie 






=| AppDelegate.swift 
»| ViewController.swift 
È Main.storyboard 
m Linguagem.playground 
[E] Images.xcassets 
ii LaunchScreen.xih 
e [| Supporting Files 
b (il eggplant-brownieTests 
- Products 


O problema é que no sistema operacional ele não cria diretório nenhum 
e, de repente, temos diversos arquivos no mesmo diretório no sistema opera- 


cional (e no nosso repositório). 


5.1 BOA PRÁTICA: CRIE UM DIRETÓRIO POR GRUPO 


Removemos esse grupo usando o delete. Antes de criar um grupo, fazemos 
um diretório com o mesmo nome no sistema operacional. Faremos isso cri- 
ando o diretório models dentro do eggplant-brownie do nosso projeto: 
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[-] eggplant-brownie > |, AppDelegate.swift 

D eggplant-br...ie.xcodeproj Base.lproj ^ 

3 eggplant-brownieTests > [3j Images.xcassets > 
Info.plist 


m Linguagem.playground 


CEE - 


> ViewController.swift 


Agora, arrastamos esse diretório para dentro do nosso projeto na pasta 
eggplant-brownie, e confirmamos, o que automaticamente cria esse 
grupo. A partir desse momento, ao criarmos os arquivos dentro desse grupo, 
eles sào automaticamente gravados no diretório que criamos, assim sempre 
teremos um sistema de arquivos refletindo o que aparece dentro do Xcode. 






noo E eggplant -teoena scodteproj 
a vogslam rms | Raid opppiamn -troan Succeeded | Today a 2141 






Destinator (M Cooy item 4 reeded ” ^u a 
O eden Added fode (8) Create groups = 


a n " E 
O Mus ervas resto - LELLT 
a Uogeme sé Add to targets MA eggoiar-beomna | metas VeewCpetrciler sn 
| oro | eggciart-brownalests rt 
a = 
A ea | 
ok 
Rees iram 
: 
Wo [umm 
E] = rm 





Aproveitamos e criamos nossos diretórios e grupos para views e 


viewcontrollers: 
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E eggplant-brownie 
2 targets, 105 SDK 8.1 
k egaplant-brownie 
*| |viewcontrollers 
* || views 
Y| | models 
K AppDelegate.swift 
(a| ViewController.swift 
[E] Main.storyboard 
m Linguagem.playground 
[E] Images.xcassets 
E LaunchScreen.xib 
E Supporting Files 
e eggplant-brownieTests 
>| | Products 


Dentro do nosso grupo models, criaremos dois arquivos Swift, 


Meal.swift e Item.swift. Para isso, clicamos no grupo models segu- 
rando o control ou com o botão direito e escolhemos New File..., Swift 
File e escolhemos o nome Meal.swift. 


class Meal { 
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var name:String 

var happiness:Int 

var items = Array<Item>() 

init(name: String, happiness: Int) 1 
self.name - name 
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self.happiness = happiness 


func allCalories() -> Double 1 
println("calculating") 
var total = 0.0 
for i in items { 
total += i.calories 
} 


return total 


Fazemos o mesmo parao Item: 


class Item { 
var name:String 
var calories:Double 
init(name: String, calories: Double) { 
self.name = name 
self.calories = calories 


Mas para que usaremos var se tais valores são, por enquanto, imutá- 
veis? Seguindo a boa prática de manter imutável aquilo que não deve mudar, 
redefinimos todos os campos, exceto o array como let: 


class Meal { 
let name:String 
let happiness: Int 
var items = Array<Item>() 
init (name: String, happiness: Int) { 
self.name = name 
self.happiness - happiness 


func allCalories() -> Double 1 
println("calculating") 
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var total = 0.0 
for i in items 1 
total += i.calories 


} 


return total 


} 


class Item { 
let name:String 
let calories :Double 
init(name: String, calories: Double) { 
self.name = name 
self.calories = calories 


Qual o motivo de não colocar o array como constante? Acontece que ele 
poderá ter seu valor alterado com o passar do tempo. Pretendemos adicionar 
itens nele através do método append que vimos antes. Portanto, o array 
ainda é mutável. 


5.2 MOVENDO ARQUIVOS NO SISTEMA OPERACIONAL 


Vamos mover por fora nosso arquivo ViewController. Primeiro, no sis- 
tema operacional, o movemos para o diretório viewcontrollers. Ao 
voltar ao storyboard, percebemos que ele está marcado em vermelho, 
como removido. Clicamos com o botão direito e confirmamos a operação 
de delete 
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Ra AOsxs 0 G8 IER | [E eggplant-brownie » |! egg) 
= & eggplant-brownie R ES 
2 targets, iOS SDK 8.1 // Meal.swift 
v [1 eggplant-brownie // eggplant-brownie 
> P viewcontrollers // Copyright (c) 2014 alu 
> EM views // 
del 
E g^ ES import Foundation 
3 tme class Meal 1 
a) AppDelegere ne let name:String 
cum lat hanninanoa TH 
EB Main.storyboard Show in Finder 
m MyPlayground.playground 
[EM Images.xcassets Open As b 
(=) LaunchScreen.xib Show File Inspector 
b m Supporting Files : 
> [1 eggplant-brownieTests New File... 
» Em Products New Project... 
Add Files to "eggplant-brownie"... 
GIT 


jeto. 





A marcacáo vermelha com a letra D só aparece caso o seu projeto es- 
teja configurado para utilizar um repositório do tipo Git. Por padráo o 
Xcode cria seu projeto dessa maneira, mas ele pode náo aparecer para 
você caso tenha desselecionado essa opção durante a criação de seu pro- 








Agora o arrastamos do sistema operacional para dentro do nosso projeto, 


dentro do grupo que queremos, o viewcontrollers. O Xcode pergunta se 


desejamos criar grupos para diretórios. Como dessa vez estamos arrastando 


somente um arquivo, podemos clicar Ok sem medo: 
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O zi a AS 
E B eggplant-brownie 
2 targets, iOS SDK 8.1 
Y ES eggplant-brownie 
7 p viewcontroallers 
a) ViewController.swift A 
Ld m views 
7 pm models 
[a Meal.swift 


= E 


a) ltem.swift 
AppDelegate.swift 
Main.storyboard 

m MyPlayground.playground 

[£x] Images.xcassets 

Èl LaunchScreen.xib 

b [DM Supporting Files 

| d [E eggplant-brownieTests 
P e Products 


B. 


| 


Já o Main.storyboard está dentro diretório Base.lproj; vamos 
movê-lo para o views. Executamos o mesmo processo de no Xcode remover 
o arquivo e efetuar o drag and drop: 
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de É eggplant-brownie 


2 targets, iOS SDK 8.1 m 
y DD eggplant-brownie 
T F1 viewcontrallers 

a| VMiewController.swift A 


[E Main.storyboard | 
v F models 
a) Meal.swift 


al Item.zwift 





3» AppDelegate.swift 
E MyPlayground.playground 
Ej Images.xcassets 
(= LaunchScreen.xib 
b Es Supporting Files 
» por eggplant-brownieTests 
- [71 Products 


Como mudamos os diretórios de diversos arquivos que estavam conec- 
tados via texto em configuracáo, precisamos garantir que todas as conexóes 
ainda estáo ok. 

Abrimos o storyboard, clicamos no ícone amarelo de 
ViewController e conferimos se a classe de nosso ViewController 
ainda é a certa: 
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Casa do Código 
< È eogpiemt-browne [M enaciant promo M views Main storvboara ` [E] View Controser Scene | E) View Controter Bo 9038 
Custom Class. 
g a E Cas VewControser oB 
= uñas B 


Se estiver certo, clicamos na seta para ver o código. Se o código náo estiver 


conectado, use O assistant editor para conectar novamente o botáo e 
as caixas de texto. 


Nosso projeto fica entáo: 
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r E 


E] zi e A E 
eggplant-brownie 
d targets, 105 SDK 8.1 
vx eggplant-brownie 
*| j|viewcontrallers 
[a] ViewController.swift 
7 a views 
= Main.storyboard 
ki models 
a| Meal.swift 
Item.swift 


E 


AppDelegate.swift 
Linguagem.playground 


E Images.xcassets 
= LaunchScreen.xib 
B- |] Supporting Files 
e egaplant-brownieTests 
B Products 


5.3 APLICANDO O BÁSICO DE ORIENTAÇÃO A OBJETOS 


Agora devemos utilizar o que aprendemos de OO em nosso projeto. De volta 


aonosso controller: 


OIBAction func add() { 
let name - nameField.text; 
let happiness - happinessField.text; 
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println("eaten: N(name) N(happiness)!") 


Podemos instanciar um novo Meal: 


OIBAction func add() { 
let name - nameField.text 
let happiness - happinessField.text 
let meal = Meal(name: name, happiness: happiness) 
println("eaten: N(meal.name) N(meal.happiness)") 


Mas o código não compila, o happiness deveria ser um número inteiro: 


@IBAction func add() { 
let name = nameField.text 
let happiness = happinessField.text.toInt() 
let meal = Meal (name: name, happiness: happiness) 
println("eaten: N(meal.name) N(meal.happiness)") 


E ainda não compila: o método toInt devolve um opcional, isso fica 
claro se tentássemos aplicar tipagem explícita: 


OIBAction func add() { 
let name:String - nameField.text 
let happiness:Int - happinessField.text.toInt() 
let meal = Meal(name: name, happiness: happiness) 
println("eaten: N(meal.name) N(meal .happiness)") 


Não estamos aqui para brincadeira, portanto só acessaremos os valores 
após ter certeza de que eles são válidos: não queremos nossa aplicação que- 
brando. Extraímos o valor de dentro deles, e removemos a tipagem explícita: 


OIBAction func add() 1 
if nameField == nil || happinessField == nil { 
return 
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let name - nameField!.text 
let happiness - happinessField!.text.toInt() 
if happiness == nil 1 

return 


let meal = Meal(name: name, happiness: happiness!) 
println("eaten: N(meal.name) N(meal .happiness)") 


No futuro veremos como mostrar uma mensagem de alerta indicando 
que ocorreu algum erro, uma mensagem educada. Testamos nossa aplicação 
e vemos que o código funciona. 
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iOS Simulator - iPhone 6 - iPhone 6 / iOS 8.1 (12B411) 


Carrier = 4:18 AM Em 
< Back new item 
Name 
Happiness 
Add 


Eggplant Brownie 
Zucchini Muffin 
Cookie 

Coconut oil 
Chocolate frosting 
Chocolate chip 


sundubu 
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Lembre-se: se por algum motivo desconhecido o campo 
happinessField tivesse um valor que não fosse válido para a trans- 
formação via toInt, teríamos um nil e nada aconteceria. 


5.4 RESUMO 


Náo só sabemos utilizar a IDE e a linguagem, mas já conhecemos diversas 
boas e más práticas de programação para IOS com Swift. Aprendemos a or- 
ganizar nossos arquivos em diretórios no sistema operacional e em grupos 
dentro do Xcode. Vimos também como aplicar os conceitos básicos de Ori- 
entacáo a Objetos ao código que havíamos implementado anteriormente. Re- 
forcamos a validacáo de valores opcionais para deixar o nosso código menos 
propício a fatal errors e crashes da aplicação. 
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CAPÍTULO 6 


Listando as refeicóes com 
TableViewController 


Nosso próximo passo é listar todas as nossas refeições atuais, permitindo lin- 
kar o usuário para uma tela onde ele adiciona uma nova refeição. Esta última 
já foi criada, mas precisamos ainda aprender a fazer uma tela com uma tabela 
e a trabalhar com a navegação entre telas, i.e. entre views, um conceito muito 
importante. 

O primeiro passo será aprender a criar uma tabela de tamanho fixo e en- 
tender o que é necessário fornecermos para criá-la. 


Começamos criando um novo projeto no Xcode, temporário, pressio- 





nando Command+Shi ft +N. Escolhemos novamente iOS, Single View 
Application e damos um nome qualquer como meal-table. Dessa vez, 
após abrirmos o Main.storyboard, não colocamos nenhum label, que- 


Casa do Código 





remos uma tabela. 

Como é extremamente comum que uma tabela seja o componente único 
deum ViewController,temos um componente já chamado Table View 
Controller, que pode ser criado como um ViewController que já pos- 
sui um único elemento: uma Table View. 

Com o storyboard de nosso projeto aberto, selecionamos nosso 
ViewController padrão e o apagamos usando o clique da direita. Nosso 
storyboard fica vazio. Na lista de componentes escolhemos e arrastamos 
um Table View Controller para nosso storyboard. 

Lembre-se de alterar o tamanho da tela para o iPhone que desejar cli- 
cando no UITableViewController, ícone amarelo à esquerda, indo nas 
propriedades e selecionando o size. 

Mas ao rodar o programa temos uma tela preta, o que aconteceu? Quando 
deletamos o ViewController inicial, o programa perdeu a referéncia do 
ponto de entrada da nossa aplicação. O ponto de entrada é indicado por uma 
seta que aparece no lado esquerdo do nosso ViewController. 

O que fazemos é selecionar o nosso Table View Controller, cli- 
cando na imagem amarela, ir às propriedades ( Attributes Inspector), 
eem Attributes Inspector marcar a opção Is Initial View 


Controller: 
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E) v E O 
i Simulated Metrics 
Size | Inferred kl 
Orientation | Inferred Eq 
Status Bar | Inferred Ed 


Top Bar | Inferred 
Bottom Bar | Inferred E 


Table View Controller 
Selection Clear on Appearance 


Refreshing Disabled = 


View Controller 
Title | 
Is Initial View Controller 


Agora sim rodamos o programa e vemos a tela com nossa tabela: 
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Carrier = 
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Primeiro fixaremos o número de linhas de nossa tabela selecionando a 
Table View. Confira que ela foi selecionada clicando dentro de onde está 
escrito Table View Prototype Content: 











Agora, na barra de propriedades à direita, mudamos o conteúdo para o 
tipo Static Cells. Assim que fazemos a mudança, fica claro que por pa- 
drão temos 3 células em nossa tabela. Se desejamos um número fixo de linhas 
nela, podemos remover células selecionando-as ou adicionar novas células 
em uma tabela utilizando o componente Table View Cell: 
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Table View 





Content | Static Cells 7 
Sections iK 
o ® Style | Plain 

æ= Separator Default — 
C | Default 








Separator Insets | Default t 


Selection | Single Selection 
Editing | No Selection During Editing + | 
M Show Selection on Touch 


Index Row Limit | — ol: 
Text ( C | Default ——— € 
Background | C 








— Normal 
C | Default 
Tracking 
Scroll View 
Style [ Default 


Scroll Indicators (VÍ Shows Horizontal Indicator 
[M Shows Vertical Indicator 
Scrolling [MÁ Scrolling Enabled 
Paging Enabled 
Z) Direction Lock Enabled 
Bounce M Bounces 


Rounee Horizantallu 


Boso 
Table View Controller - A 
controller that manages a table view. 
Table View - Displays data in a list 
of plain, sectioned, or grouped rows. 


Table View Cell - Defines the 
attributes and behavior of cells (rows) 
in a table view. 























wAny hAny E Hm o: 


Adicionamos a quarta célula arrastando o componente do canto inferior 
direito para nossa tabela para exemplificar o funcionamento de uma tabela 
customizada. Agora queremos que cada uma das células contenha um texto 
básico. Isto é, queremos que o estilo de nossas células seja basic. Para isso, 
selecionamos as quatro células usando o command click em cada uma 
delas. Nas propriedades, alteramos o style para basic e o resultado são 
quatro linhas com o texto Title, que funciona basicamente como um label 
tradicional: 


94 


Casa do Código 


Capítulo 6. Listando as refeições com TableViewController 




















o m 
Title 
Title 
Title 
Title 
wAny hAny 


B Ho t E 








Table View 
Content [ Static Cells isi 
Sections NO 
Style | Plain n 
Separator | Default i 
CE) | Default + 
Separator Insets | Default q 
Selection | Single Selection + 


Editing | No Selection During Editing + 
M Show Selection on Touch 


Index Row Limit ol] 


Text | C= | Default 
Background [ C= | Default 








o a .. Normal 
C | Default 
Tracking 
| Scroll View 
Style | Default : 


Scroll Indicators (M Shows Horizontal Indicator 
(MÍ Shows Vertical Indicator 


Scrolling M Scrolling Enabled 
C Paging Enabled 
[ | Direction Lock Enabled 


Bounce (VÍ Bounces 
D Raunce Harizantally 


noom 


Table View Controller - A 
controller that manages a table view. 


- | Table View - Displays data in a list 
| of plain, sectioned, or grouped rows. 

















Table View Cell - Defines the 
>> | attributes and behavior of cells (rows) 
in a table view. 




















Usando o double click em cada um dos textos, alteramos seus valores 


para quatro refeições distintas: 
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egaplant brownie 


guilherme's sundubu 


dani's cheesecake 


zucchini muffin 
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Rodamos o programa e temos nossa tabela! 





SELECIONANDO O VIEW CONTROLLER INICIAL 


Caso ainda tivéssemos o View Controller inicial, poderíamos ter 
arrastado asetaparao Table View Controller, indicando com isso 
que ele seria o ponto de entrada de nossa aplicação. 











6.1 TABELAS DINÂMICAS USANDO DYNAMIC PRO- 
TOTYPES 


Mas nem sempre sabemos em tempo de programação quantas linhas dese- 
jamos ter em uma tabela e seu conteúdo exato. Em geral, desejamos que a 
tabela represente um conjunto de dados que temos em memória, algum tipo 
de Array. À medida que modificamos o Array desejamos atualizar a tabela 
para refletir tal mudança. 

Para isso, usaremos um outro tipo de tabela, a baseada em 
Dynamic Prototypes. Criamos um novo projeto com Single 
View Application como feito anteriormente. Podemos chamá-lo de 
dynamic-meal-table. Arrastamos um Table View Controller e 
arrastamos a seta para que ele possa ser nossa tela inicial. Deletamos também 
o View Controller original. 

Escolhendo agora nossa tabela, conferimos a opção Content na barra 
de propriedades à direita, que já deve estar selecionada como Dynamic 
Prototypes. 

Agora queremos conectar nosso código ViewController.swift com 
esse NOVO controller que criamos no storyboard. Como fazer isso? 
Selecionando o Table View controller, clicando em seu ícone amarelo 
no tipo da janela do table view à direita: 
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Prototype Cells (m 
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Podemosno Identity Inspector (terceiro ícone da esquerda pra di- 
reita na barra de propriedades) escolher quem é o código que identifica esse 
controller no nosso storyboard. Estamos conectando a view inteira 
com a nossa classe Swift. 

Estranhamente, ao começar a digitar ViewController (o nome de 
nossa classe), o Xcode não a sugere, por quê? 

Acontece que nossa classe não representa um 
UITableViewController, mas somente um  ViewController co- 
mum. Alteramos nosso código para herdar de UlTableViewController 


já removendo o segundo método que não nos interessa: 


class ViewController :: UlTableViewController 1 


override func viewDidLoad() 1 
super. viewDidLoad () 


Mas para nosso teste, alteraremos o viewDidLoad para que, ao ter a 
view carregada, mostremos uma mensagem de sucesso: 


override func viewDidLoad() 1 
super. viewDidLoad() 
println("view did load") 
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HERANÇA, SUPER E ALTO ACOPLAMENTO 


A palavra-chave override indica que estamos sobrescrevendo um 
método que já existia em nossa classe mãe. 

O que é esse tal de super? Ele invoca o método com a assinatura 
(nome e parâmetros) definido na classe mãe (ou pai, tanto faz), no nosso 
caso UITableViewController. Como não sabemos o que o método 
faz na classe mãe, é importante o chamarmos para que ele inicialize o que 
for necessário. 

A palavra super entrega ao programador atento a existência um alto 
acoplamento entre classes que usam herança: a classe filha tem que en- 
tender muito bem o código da classe mãe para saber quando ela tem que 
chamar super obrigatoriamente e quando ela não pode chamar super. 
O uso indiscriminado de herança pode levar a problemas de manutenção 
de código a longo prazo. 

http://blog.caelum.com.br/como-nao-aprender-orientacao-a-objetosjheranca/ 











Uma vez salvas as alterações no ViewController, de volta ao 
storyboard, a IDE sugere o ViewCont roller como classe que customiza 
o comportamento de nosso controller: 





| nmoHcosSseo 


Custom Class 


Class 





Madule | None -* | 


Rodamos o programa e temos nossa tela sem nenhuma célula, mas já co- 
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nectada ao controller, podemos conferir isso analisando o log, que mos- 
tra nossa mensagem impressa durante o viewDidLoad: 


| view de tabela carregada 


| All Output ? uU rp 


Precisamos agora do Array que representará os alimentos a serem mos- 
trados. Como esse projeto novo náo possui nossas refeicóes, comecaremos 
com uma simples, de St rings: 


let meals - [ "eggplant brownie", "zucchini muffin"] 
BEP 


Mas como armazenar essas refeições de tal maneira que elas fiquem na 
memória enquanto nosso controller existir? Podemos colocar nosso mo- 
delo que está sendo exibido (neste caso, a Array de Strings) como propri- 
edades de nossa classe: 


class ViewController: UlTableViewController 1 
let meals - [ "eggplant brownie", "zucchini muffin"] 
override func viewDidLoad() 1 


super. viewDidLoad () 
println("view did load") 


Assim como fizemos com a tabela com tamanho fixo, queremos dizer a 
ela quantas linhas desejamos ter. Mas em vez de notificarmos a tabela, nós 
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seremos perguntados por ela, isto é, escrevemos uma função que devolve o 
nümero de linhas que nossa Table View terá: 


func howManyLinesDoWeHaveIn0urTable() -> Int { 
return meals.count 


Esse método já existe com o retorno padrão o, e desejamos reescrevê-lo. 
Seu nome é tableView e ele recebe dois parámetros que não utilizaremos: 


override func tableView(tableView: UlTableView, 
numberOfRowsInSection section: Int) -> Int { 
return meals.count 


Ao tentarmos rodar, temos um problema. Acontece que falamos o nú- 
mero de células desejadas mas náo o valor de cada uma delas. Aí nào dá... 
Vamos definir o valor de cada uma de maneira análoga ao que fizemos com 
uma tabela de tamanho. 

Podemos parar o programa clicando no stop e voltar a ver o nosso pro- 
jeto clicando em Project Navigator (primeiro ícone da barra de nave- 


gacáo à esquerda). 
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© ab 


05 


i) Memory 11,8 MB 


n 
Lj Disk Zero KB/s 


Lu Network Zero KB/s 


Thread 1 
v n Queue: com.apple.main-thread (serial) A 


E o —Pthread_ kill 


Lr 37 UlApplicationMain 
4 38 top level code 
39 main 

E 40 start 


e Thread 2 
Queue: cam.apple.libdispatch-manager... 


b m Thread 3 





» " Thread 4 
P M Thread 5 
» "n Thread 6 
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Reescreveremos um outro método da t ableview. Em vez dos dois pa- 
râmetros anteriores (tabela e número de linhas), recebemos a tabela e a linha 
da qual ele quer saber a célula a ser utilizada: 


override func tableView(tableView: UlTableView, 
cellForRowAtIndexPath indexPath: NSIndexPath) 
-> UITableViewCell 1 
let row - indexPath.row 
let meal = meals[ row ] 


Agora que extraímos a linha em que estamos interessados, criamos uma 
nova view do tipo UITableViewCell com o estilo padráo e sem passar 
um identificador: 


override func tableView(tableView: UlTableView, 
cellForRowAtIndexPath indexPath: NSIndexPath) 
-> UITableViewCell 1 
let row = indexPath.row 
let meal = meals[ row ] 


var cell - UITableViewCell( 
style: UITableViewCellStyle.Default, 
reuseIdentifier: nil) 


Já temos a célula. Vamos alterar seu texto para o valor da refeicáo e retor- 
namos: 


override func tableView(tableView: UlTableView, 
cellForRowAtIndexPath indexPath: NSIndexPath) 
-> UITableViewCell 1 
let row = indexPath.row 
let meal = meals[ row ] 


var cell - UITableViewCell( 
style: UlTableViewCellStyle.Default, 
reuseldentifier: nil) 
cell.textLabel.text - meal 
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return cell 


O código final de nosso controller é: 


import UIKit 
class ViewController: UlTableViewController 1 
let meals = [ "eggplant brownie", "zucchini muffin" ] 


override func viewDidLoad() 1 
super. viewDidLoad O 
println("view did load") 


override func tableView(tableView: UlTableView, 
numberOfRowsInSection section: Int) -> Int ( 
return meals.count 


override func tableView(tableView: UlTableView, 
cellForRowAtIndexPath indexPath: NSIndexPath) 
-> UlITableViewCell 1 
let row = indexPath.row 
let meal = meals[ row ] 
UITableViewCell( 
Style: UlTableViewCellStyle.Default, 
reuseldentifier: nil) 
cell.textLabel.text - meal 
return cell 


ll 


var cell 


Rodamos novamente e temos uma tabela dinâmica, com os dois elemen- 
tos que representam as duas refeições! 
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COEM brownie des 


zucchini muffin 
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VIEW 


é uma view quanto a 


o UITableViewContr 





Uma view é um componente visual qualquer. Tanto o controller 
dem ser colocadas umas dentro das outras para compor uma view 
mais complexa. Nesse nosso caso, temos um controller com uma 


table view com diversas table view cell. Enquanto criamos 


componentes, criamos as UITableViewCell programaticamente. 


Label e uma célula são views. Views po- 


oller visualmente, arrastando-o da barra de 








Agora é hora de aplicar 


6.2 RESUMO 


isso tudo em nosso projeto! 


Vimos como criar uma tabela de tamanho fixo, uma tarefa que pode ser apli- 


cada quando temos determinadas características a serem configuradas ou op- 


ções a serem selecionadas dentro de um conjunto predeterminado, cujo de- 


senvolvedor pode escrever em tempo de desenvolvimento. 


Passamos pela criação de um controller que já possui um único ele- 


mento, a tabela em si, o UlLTableViewCont roller e aprendemos a indicar 


qual é o ponto de início de nossa aplicação. 





Criamos um controller que mostrava uma tabela refletindo o número 


de elementos contidos em um array, assim como customizamos o conteúdo 


da célula dessas tabelas de acordo com o conteúdo desse array. 
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Projeto: lista de refeições 


Agora que já somos capazes de criar uma nova refeição, e sabemos criar uma 
tabela, desejamos criar uma visualização capaz de mostrar todas as refeições. 

Como fazer isso? Se desejamos uma nova visualização no nosso 
projeto original ( eggplant-brownie), podemos adicionar um novo 
ViewController, um que inclua dentro dele um componente que seja 
uma listagem de refeições, uma tabela. Podemos simplesmente adicionar um 
TableViewController. Abrimos nosso Main.storyboard, procura- 
mos o TableViewController na lista de componentes no campo infe- 
rior direito e o puxamos para nosso storyboard. Lembre-se de já mudar o 
size dele para o de iPhone que estamos utilizando até agora. 

Diferentemente do que acontecia até agora nessa aplicação, desejamos 
que ela comece com essa view, e não a anterior, a view de adicionar refei- 
ção, portanto movemos a seta de starting point de nossa aplicação para esse 
novo controller. 
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B m Table View Controller 
= Prototype Cells -— 


Name: 
Happiness: 


add 








Queremos que essa tabela seja dinámica, e à medida que adicionemos no- 
vos elementos na lista de refeições, ela reflita essa nossa lista. Temos diversos 
passos para implementar: 


e Criar o código de nosso controller; 
e Criar um array de refeições; 


e Fazer a tabela refletir os dados do array de refeições; 


Permitir clicar em um botão e ir para a tela de adicionar refeição; 
e Ao voltar da tela de adicionar refeição, atualizar o array de refeições. 


Começamos criando o código de nosso controller. Na pasta 
viewcontrollers, clicando com o botão direito ou com um control- 
click, escolhemos New File.... Selecionamos Source dentro de 
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ios e, clicando duas vezes em Cocoa Touch Class, damos o nome 
Meals e escolhemos o tipo UITableViewController, resultando em 





MealsTableViewController. Confirmamos que escolhemos swift 
como linguagem: 


| Choose options for your new file: 


Class: MealgTableViewController 


Subclass of: | UlTableViewController Y 
| Also create XIB file 


iPhone 


Language: | Swift | 








[ Cancel | | Previous | [Next] 





O Xcode cria um novo ViewCont roller que agora herda o comporta- 
mento de UlTableViewCont roller. A classe criada possui diversos mé- 
todos implementados e comentados, mas como, em geral, não vamos usá-los, 
podemos apagar todos os métodos. Já já escreveremos os métodos que nos 
interessam. 

Precisamos conectar a view do nosso storyboard como controller 
que acabamos de criar, fazendo isso na propriedade de classe customizada, 
como fizemos anteriormente no storyboard: 
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D o v E O 


Custom Class 






* 
Module | None |» | 


Cuidado para não tentar customizar a classe somente de sua 
UITableView, o Xcode não dará a sugestão que deseja. Escolha seu 
MealsTableViewController clicando no ícone amarelo que representa 
selecionar o view controller para só então alterar a classe que a 
identifica. 

Se rodarmos a aplicação, percebemos que não aparece nenhuma linha 
preenchida. Agora é a hora de criarmos nossas refeições iniciais: 


class MealsTableViewController: UITableViewController { 


var meals = [ Meal(name: "Eggplant brownie", happiness: 5), 
Meal (name: "Zucchini Muffin", happiness: 3)] 


Implementamos também o código para definir o número de linhas refle- 
tindo o total de refeições em nosso array: 


override func tableView(tableView: UlTableView, 
number0fRowsInSection section: Int) -> Int { 
return meals.count 


O método que devolve o conteúdo de cada linha extrairá o nome de cada 
refeicáo: 
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override func tableView(tableView: UlTableView, 


let 
let 


Var 


cellForRowAtIndexPath indexPath: NSIndexPath) 
-> UlTableViewCell 1 

row = indexPath.row 

meal = meals[ row ] 


cell = UITableViewCell( 
style: UlTableViewCellStyle.Default, 
reuseIdentifier: nil) 


cell.textLabel.text - meal.name 


return cell 


Rodamos a aplicação: agora temos uma tela com todas as refeições! Mas 


ainda temos algo de estranho por aqui, como faremos para adicionar uma 


nova refeição? Precisamos de uma barra de navegação, que veremos em breve. 


71 RESUMO 


Vimos neste capítulo como criar un TableViewController que mos- 


tra todas as refeições, além de configurá-lo para ser o novo ponto 


de entrada de nossa aplicação. ^ Sobrescrevendo métodos de nosso 


TableViewController, fomos capazes de configurar a quantidade de li- 


nhas e o conteúdo de cada célula de nossa tabela para seguir os dados presen- 


tes em um array de objetos. 
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Navegando entre telas 


Precisamos fornecer uma maneira para nosso usuário sair da listagem de re- 
feições e ir para a tela de nova refeição: queremos trabalhar com a navegação 
entre telas. Ele precisa navegar entre a tela de listagem e a de nova refeição, 
tanto a ida quanto a volta. Queremos uma barra de navegação, e isso pode ser 


feito através deum Navigation Controller. 





Comecamos clicando em nossa tabela e, no menu Editor, submenu 
Embed In, escolhemos Navigation Controller, fazendo com que 





nosso controller tenha agora uma barra de navegação. Como de costume, 





mude o tamanho do seu Navigation Controller. Note também que o 
Xcode já moveu o ponto de entrada do programa para a tela com navegação: 
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gs 





Primeiro, foi criado um Navigation Controller e nosso 
MealsViewController foi alterado para ser a raiz ( root), o ponto 
de entrada desse Navigation Controller. Na prática, 0 Navigation 
Controller é só uma capa que veste o nosso controller inicial. A partir 
daí, a navegação é feita sempre mantendo essa capa de navegação. Portanto, 
não faremos nada agora no Navigation Controller em si, mas no 
nosso controller antigo. 

Note que, no nosso controller antigo, temos uma barra de navegação, 
na qual podemos adicionar um componente chamado Bar Button Item, 
e mudamos seu nome para Add. 
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Background | [= | Default $) 
o q Normal 
(mm | C | Default el 
Tracking 
Scroll View 
Prototype Cells Style | Default +] 





Scroll Indicators M Shows Horizontal Indicator 
T Shows Vertical Indicator 





Bar Button Item - Represents an 
item on a UlToolbar or 
UlNavigationltem object. 














Fixed Space Bar Button Item - 
þe) Represents a fixed space item on a 
UlToolbar object. 


d / 


Flexible Space Bar Button Item - 
49» Represents a flexible space item on a 
UlToolbar object. 











Agora, com a tecla Control apertada, arrastamos o botáo para nossa 
tela de Adicionar Refeição, escolhendo a opção Action Segue -> 
show, isto é, ao clicar no botáo, mostre essa tela. 
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View Controller 








add Name 


Prototype Cells 
Happiness 


Add 


Action Segue 
show 
show detail 


present modally 
popover presentation 
custom 

Non-Adaptive Action Segue 
push (deprecated) 
modal (deprecated) 














Podemos perceber que alguns campos do formulário ficaram atrás da 
barra de navegação. Para fazer com que apareçam embaixo da barra, cli- 
camos no View Controller do formulário e, no menu de propriedades 
(Attributes Inspector), desmarcamos Under Top Bars. Pronto, 
agora os campos sáo deslocados automaticamente para baixo. 

Rodamos o programa e percebemos que, ao clicar no botáo, vamos direto 
para a tela de nova refeição. Perfeito, mas ao clicar em adicionar, não voltamos 
para a tela anterior. Temos que fazer a volta. 
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8.1 NAVEGANDO COM UMA PILHA DE TELAS 


Para fazer a volta, devemos dizer para nosso cont roller de navegação que 
desejamos voltar atrás na tela atual. Isto é, cada vez que mostramos uma tela 
de maneira tradicional (chamada de push), estamos empilhando uma tela 
em cima da outra. 

Quando desejamos remover a tela atual de cima da anterior, usamos o 
método pop. Portanto, em nossa função add, no ViewController, de- 
vemos pegar nosso navigationController (que é opcional) e falar para 
ele remover o view controller de maneira animada: 


self.navigationController!.popViewControllerAnimated(true) 


Cuidado | com | métodos de nome parecido com o 
popViewControllerAnimated, a escolha de outro método trará um 
outro efeito, claro. 

Mas, opa, nosso atual controller pode e pode não ter um 
navigationController, sendo assim estamos acessando uma variável 
que pode destruir nossa aplicação. Podemos nos proteger usando a constru- 
ção let: 


if let navigation = self .navigationController { 
navigation.popViewControllerAnimated(true) 


Agora sim, temos nosso método add que extrai os dados, transforma 
o número e volta pra tela anterior, sempre com a garantia de que erros de 
inicialização ou de entrada do usuário não quebrarão nossa app: 


OIBAction func add() { 
if nameField == nil || happinessField == nil 1 
return 


let name - nameField!.text 
let happiness - happinessField!.text.toInt() 
if happiness == nil { 

return 
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let meal = Meal(name: name, happiness: happiness!) 
println("eaten: N(meal.name) N(meal.happiness)") 


if let navigation = self .navigationController 1 
navigation.popViewControllerAnimated(true) 








NAVIGATION OPCIONAL? 


é uma variável opcional do meu controller? Acontece que, devido à 
decisão da API de fazer com que um UIViewController sempre te- 
nha essa variável, ela pode estar setada ou não... pois você pode estar 
dentro de um UINavigationViewController ou não. Em tempo 
de compilação, a API não sabe disso, portanto deixa a variável como op- 
cional. 


anteriores, o que é muitas vezes indesejado) para que a variável só exis- 
tisse em compilação caso seu controller estivesse realmente dentro 
deum navigation controller, evitando a variável opcional e pos- 
síveis erros em tempo de execução. 


enquanto convivemos com tal variável opcional e o perigo de acessá-la 
sem verificar seu valor. 


E a pergunta de 1000 reais: como assim o navigationController 


A API poderia ser recriada (quebrando compatibilidade com versões 


Mas como toda decisão de quebrar compatibilidade é perigosa, por 








Testamos novamente nossa aplicação e, agora, quando clicamos no botão 


de adicionar, ele desempilha nossa tela, mostrando a tela de refeições nova- 


mente. 
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8.2 RESUMO 


Vimos como podemos criar um NavigationController que permite 
a navegacáo entre diversos View controllers.  Apresentamos um 
controller com o push de um segue e voltamos para a tela anterior 


com o pop programático. 
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CAPÍTULO 9 


Design pattern: delegate 


Nosso próximo passo é conseguir atualizar nossa tela com a refeição que acaba 
de ser criada. Como fazer isso? Pode ser de diversas maneiras: a primeira é fa- 
zer com que a lista fique perguntando a todo o momento se uma nova refeição 
foi criada. Esta técnica é chamada de polling e parece não se encaixar de 
jeito nenhum aqui. Uma segunda forma é pedir para que o formulário avise 
que uma nova refeição foi criada, e quem quiser pode escutar este evento e 
fazer as ações necessárias. 

Esta última é a implementação do padrão chamado Delegate: o formu- 
lário delega a responsabilidade de adicionar o resultado no array para alguém 
que sabe terminar esse trabalho, atualizando a tela com a nova refeição. Esse 
design pattern lembra o Observer do livro “Design Patterns: Elements of 
Reusable Objected-Oriented Software”, onde um outro objeto é notificado de 
um evento que ocorreu. 

Primeiro, precisamos que nosso MealsTableViewController seja 
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capaz de adicionar uma nova refeição ao array existente. Adicionamos nele 
um método add: 


func add(meal: Meal) 1 
meals .append (meal) 


Agora, o formulário do ViewController, após adicionar a nova refei- 
ção, deve invocar uma ação que faça o registro dela para quem precisar ser 
informado deste evento, ou seja, parao delegate desta ação: 


@IBAction func add() 1 
if nameField == nil || happinessField == nil { 
return 


let name = nameField!.text 
let happiness = happinessField!.text.toInt() 
if happiness == nil { 

return 


let meal = Meal(name: name, happiness: happiness!) 
println("eaten: \(meal.name) \(meal.happiness)") 


delegate .add (meal) 


if let navigation = self.navigationController { 
navigation.popViewControllerAnimated (true) 


Mas onde está a variável delegate? Precisamos criá-la como proprie- 
dade, para que alguém possa configurá-la: 


var delegate:MealsTableViewController 


@IBAction func add() 1 
if nameField == nil || happinessField == nil { 
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return 


let name - nameField!.text 
let happiness - happinessField!.text.toInt() 
if happiness == nil 1 

return 


let meal = Meal(name: name, happiness: happiness!) 
println("eaten: N(meal.name) N(meal .happiness)") 


delegate.add(meal) 


if let navigation = self.navigationController { 
navigation.popViewControllerAnimated(true) 


Mas se nosso delegate só vai ser configurado após o 
ViewController ser criado, precisamos deixá-lo como variável opci- 


onal: 


var delegate:MealsTableViewController? 


OIBAction func add() { 
if nameField == nil || happinessField == nil { 
return 


let name - nameField!.text 
let happiness - happinessField!.text.toInt() 
if happiness == nil 1 

return 


let meal = Meal(name: name, happiness: happiness!) 
println("eaten: N(meal.name) N(meal .happiness)") 
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delegate.add(meal) 


if let navigation = self.navigationController 1 
navigation.popViewControllerAnimated(true) 


E já sabemos que, se é opcional, temos que cuidar com carinho: 


var delegate:MealsTableViewController? 


OIBAction func addO 1 
if nameField == nil || happinessField == nil { 
return 


let name - nameField!.text 
let happiness - happinessField!.text.toInt() 
if happiness == nil { 

return 


let meal = Meal (name: name, happiness: happiness!) 
println("eaten: N(meal.name) N(meal.happiness)") 
if delegate == nil { 

return 
delegate!.add(meal) 


if let navigation = self.navigationController 1 
navigation.popViewControllerAnimated (true) 


Rodamos o nosso programa, a mensagem de log aparece mas náo saimos 
da tela. Clicamos no botão 'Back' e não temos o elemento na tabela. Isso 
acontece porque a nossa variável opcional, o delegate, náo foi configurada! 


126 


Casa do Código Capítulo 9. Design pattern: delegate 





Portanto o 'println foi executado e logo depois a execução parou a chamada 
a nossa função 'add' pois 'delgate == nil“ era verdadeiro. 

Quem será então nosso delegate? Quem observará a view de adicio- 
nar refeição para ser notificado quando uma nova refeição foi criada? Nosso 


MealsTableViewController. 


9.1 CONFIGURANDO UM DELEGATE VIA SEGUE 


Precisamos agora notificar o ViewController de que nós, 
MealsTableViewController, somos o seu Observer, o seu delegate. 
Mas como fazer isso se a conexão entre os dois controllers é feita via 
uma seta (um segue) no storyboard, e não via programação? Como passar 
um parâmetro via programação para outro controller, sendo que a 
conexão é feita via arrasta e solta? 

Se tivéssemos acesso ao controller de destino na hora da navegação, 
poderíamos pegar o objeto e colocar nosso delegate nele. 

Nossos controllers nos disponibilizam um momento de alegria antes 


de redirecionarem para outra view. Ao se preparar para seguir um segue, o 





controller invoca um método chamado prepareForSegue, onde po- 
demos sobrescrever e fazer algo com o que será mostrado. 


override func prepareForSegue (segue: 
UlStoryboardSegue, sender: AnyObject?) 1 


Repare que a função recebe um segue, aquele que ele está seguindo. Mas 
como sabemos qual ele está seguindo? Precisamos de algum identificador, de 
um id. Vamos em nosso storyboard, clicamos no segue e, em seguida, no 
menu Attributes Inspector, vamos configurar seu identificador como 
addMeal. 
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m PPP 


Vea Contratos 








Agora sim, em nosso prepareForSegu do 
MealsTableViewController podemos condicionar a execução ao 
segue que desejamos: 


override func prepareForSegue (segue: UIStoryboardSegue, 
sender: AnyObject?) 1 
if(segue.identifier == "addMeal") { 


O que falta agora é pegar nosso controller de destino, que podemos 
obter da própria segue: 


override func prepareForSegue(segue: UIStoryboardSegue, 
sender: AnyObject?) { 
if(segue.identifier == "addMeal") ( 

let view - segue.destinationViewController as ViewController 
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E setarmos nosso delegate: 


override func prepareForSegue (segue: UlStoryboardSegue, 
sender: AnyObject?) 1 
if(segue.identifier == "addMeal") { 
let view - segue.destinationViewController as ViewController 
view.delegate - self 


Pronto. Testamos nossa aplicacáo, a refeicáo é adicionada com sucesso: 
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Eggplant brownie 
Zucchini Muffin 


dani's cheesecake 
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BOA PRÁTICA: RECARREGUE OS DADOS DE UMA TABELA 


Nosso código de adicionar nova refeicáo está bem simples: 


func add(meal: Meal) 1 
meals.append(meal) 


Mas a tabela nào é redesenhada automaticamente só por ter adicio- 
nado um elemento novo em um array. No nosso caso, ela é redesenhada 
pois retiramos um ViewController que estava na frente, forcando a 
aparição da tabela novamente. Como o método add pode ser chamado 
em situações em que o pop não seria chamado, é interessante garantir 
que, toda vez que adicionamos algo através desse método, a tabela seja 
redesenhada. Para isso, invocamos o método reloadData de nossa 
tableView: 


func add(meal: Meal) ( 
meals .append (meal) 
tableView.reloadData() 











9.2 CODE SMELL: NOMES GENÉRICOS DEMAIS E COMO 
EXTRAIR UM PROTOCOLO 


Mas qual o tipo da variável delegate? Sério mesmo que é 
MealsTableViewController? Isto é, no código de um controller 
temos uma referência para o outro, e no outro para o um, explicitamente. 
Quanto maior o acoplamento entre duas classes, mais complexo fica mudá-las 
sem uma alterar a outra, e isso é algo que queremos evitar, claro. 

Esta variável precisa ser de um tipo que possua obrigatoriamente o mé- 
todo add para que possamos invocá-lo, mas não precisa ter todo o resto 
que um MealsTableViewController tem. Para podermos garantir que 
o nosso delegate terá com toda a certeza o método add, temos que fa- 


131 


9.2. Code smell: nomes genéricos demais e como extrair um protocolo Casa do Código 





zer com que ele assine uma espécie de um contrato que o obrigue a ter este 
método. Um contrato funciona como uma interface: todos que a implemen- 
tarem devem cumprir com os métodos definidos lá dentro. Este contrato é 
chamado de Protocol. 

Precisamos extrair o protocolo que tenha o método add que recebe um 
Meal: 


protocol MyDelegate 1 
func add(meal: Meal) 


Como este protocol será utilizado para que nosso ViewController 
consiga invocar o delegate, vamos declará-lo no mesmo arquivo de nosso 
ViewController, 0 ViewController.swift logo antes da declaração 
da classe: 


protocol MyDelegate { 
func add(meal: Meal) 


class ViewController: UlViewController 1 
//restante do código 


} 


Falta decidir qual nome usar para nossa interface, nosso protocol, 
MyDelegate não parece um nome que diz muito sobre nosso domínio ou 
o que o protocolo faz. Existe uma convenção da Apple para nomes de proto- 
colos, criada na época do Objective-C: http://bit.ly/swiftcodenamingbasics 

Mas para os casos de Delegate a regra que a Apple utiliza em sua API, 
é de colocar o nome da classe que terá seu comportamento delegado mais 
a palavra Delegate. Veremos em breve o UITableViewDelegate, por 





exemplo. Em nosso caso, temos então ViewControllerDelegate: 


protocol ViewControllerDelegate { 
func add(meal: Meal) 
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Nomenclatura de protocolos 


O problema dessa convenção ao mesmo tempo oficial e não oficial no 
padráo do delegate está ligado à sua desconexáo do nosso domínio. O 
que um ViewControllerDelegate faz? Nào tenho ideia. O que um 
AddAMealDelegate faz? Ele adiciona uma refeição. A desconexão do nosso 
projeto com o domínio de negócios é um dos fatores que dificulta a manuten- 
ção do código. Além disso, uma das maneiras de ver esse delegate é como 
um Observer; notifique-me quando uma nova refeição for criada. Teríamos 
um protocolo totalmente diferente: 


protocol MealsObserver 1 
func created(meal: Meal) 


O resultado seria o mesmo, sendo uma mera discussáo de "qual design 
pattern estou usando”, portanto de “qual nome devo usar”. 

No nosso caso, vamos fugir do padrão viewControllerDelegate por 
um único motivo: ele nos induz a manter um único delegate. E se dese- 
jássemos ter dois delegates para uma ünica tela, como por exemplo um 
dashboard de funções de nossa aplicação, em que cada gráfico clicado gera 
uma ação totalmente diferente? Usando o padrão mencionado, teríamos um 
único Delegate? O desenvolvedor, para tentar seguir o padrão, se sentiria 
tentado a manter o código todo em um único lugar. 

Em vez de colocarmos muita responsabilidade em um único lugar, vamos 
lutar pela separação de responsabilidades e por protocolos menores, sendo 
assim, já escolheremos um nome de domínio para nosso Delegate. 

Queremos um nome de Delegate que faça sentido para nosso domí- 
nio, um protocolo que define quem será capaz de adicionar refeições, um 
AddAMealDelegate. Nosso protocolo é, na verdade: 


protocol AddAMealDelegate 1 
func add(meal: Meal) 


Agora podemos colocar o tipo de nossa variável: 


var delegate:AddAMealDelegate? 
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Temos também que falar que nossa classe 
MealsTableViewController adota esse protocolo: 


class MealsTableViewController: UlTableViewController, 
AddAMealDelegate 1 


// 


Portanto, o código de nosso ViewController fica: 


import UIKit 


protocol AddAMealDelegate { 
func add(meal: Meal) 


class ViewController: UlViewController 1 


0IBQutlet var nameField: UITextField! 
OIBOutlet var happinessField: UITextField! 


var delegate:AddAMealDelegate? 


OIBAction func add() 1 
if nameField == nil || happinessField == nil { 
return 


let name - nameField!.text 
let happiness = happinessField!.text.toInt() 
if happiness == nil 1 

return 


let meal - Meal(name: name, happiness: happiness!) 
println("eaten: N(meal.name) N(meal .happiness)") 


if delegate == nil { 
return 
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delegate! .add(meal) 


if let navigation = self.navigationController { 
navigation.popViewControllerAnimated(true) 


Testamos novamente nossa aplicação e o código está funcionando. 





MÁ PRÁTICA: MUITOS SEGUES COM PARÁMETROS 


O uso de muitos segues gera um código cheio de ifs, também 
conhecido como switch. Ambos sáo indicadores de que existe muita 
responsabilidade em um ünico ponto de nosso código, o que o torna 
cada vez mais difícil de manter. Existem diversas técnicas para evi- 
tar esses ifs, como o uso de polimorfismo em Orientação a Obje- 
tos. Veremos mais à frente como evitar a passagem de parámetro via 
prepareForSegue fazendo como os desenvolvedores séniores, usando 





programacáo normal. 











9.3 RESUMO 


Conhecemos aqui o padráo observer que é aplicado com o nome de 
Delegate para notificar uma outra tela de uma acáo realizada na tela atual. 
Quem observa a notificacáo náo precisava necessariamente ser outra tela, bas- 
tava implementar um protocol que definimos. 

Precisamos dar uma identificação para o segue para que ele possa ser 
utilizado durante a preparacáo de redirecionamento, o momento no qual con- 
figuramos em nosso view controller quem será o delegate a ser invocado. 

O delegate é o coração da comunicação entre telas, sem ele seríamos 
obrigados a apelar para variáveis globais - a maior de todas as quebras de 
encapsulamento. 
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O post da Caelum http://bit.ly/singletons-static tem uma explicacáo sobre 
alguns motivos pelos quais variáveis globais são perigosas para a manutenção 
de uma aplicação. 

Os nomes de classes, métodos e variáveis são importantes para a manu- 
tenção de um código em longo prazo e a discussão é uma que ainda está em 
aberto. Por um lado, temos uma convenção que nos leva a acumular respon- 
sabilidades em um único protocolo, e posteriormente em uma única classe, 
por outro lado, um nome que foge da convenção. 
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CAPÍTULO 10 


Relacionamento um para muitos: 
lista de alimentos 


Ao adicionar uma nova refeicáo, devemos escolher quais sáo os alimentos que 
a compóem. Isto é, desejamos mostrar a lista de itens na tela de nova refei- 
cáo. Se vamos mostrar uma lista, adicionaremos uma tabela. Mas como fazer 
isso seo controller que vimos até agora para a criacáo de tabelas permi- 
tia somente a existéncia de tabelas? Vamos adicionar um único componente 
novo ao controller de nova refeição: uma TableView, arrastando, como 
sempre, a view do canto inferior direito até nosso view controller no 
storyboard: 
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Name: 


Happiness: 
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Como toda TableView dinâmica, devemos indicar quem será o objeto 
responsável por implementar os métodos que descrevem uma tabela, como o 
número de células e seu conteúdo. 

Como queremos que nosso view controller seja responsável por tais mé- 
todos, devemos primeiro fazer com que ele implemente os protocolos ade- 
quados ou herde de UITableViewController. Mas não somos bem um 
UITableViewController, certo? Nào queremos assumir mais responsa- 
bilidades do que realmente devemos, portanto preferimos implementar so- 
mente o protocolo que fornece os dados da tabela, a fonte de dados, o data 
source, o protocolo chamado UITableViewDataSource: 


class ViewController: UlViewController, UlTableViewDataSource { 


// 


No storyboard, selecionamos nosso ^ TableView e, na aba 
Connections Inspector (ültimo ícone na barra de propriedades), 
puxamos o dataSource para o ícone de nosso View Controller 
(aquele amarelo no topo da tela de adicionar): 
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Precisamos implementar agora os métodos tableView que retornam a 
quantidade de alimentos dentre os quais o usuário selecionará os que entra- 
ram na refeição, além do método que devolve o conteúdo de cada célula. Para 
isso, vamos primeiro criar um array com todos os alimentos possíveis. Se- 
gundo minha esposa confeiteira, o brownie de berinjela pode combinar com 
uma cobertura de chocolate, enquanto o muffin de abobrinha vai bem com 
gotinhas de chocolate. Criamos alguns itens para nossas sobremesas saudá- 
veis com coberturas opcionais: 


var items = [ Item(name: "Eggplant Brownie", calories: 10), 
Item(name: "Zucchini Muffin", calories: 10), 
Item(name: "Cookie", calories: 10), 
Item(name: "Coconut oil", calories: 500), 
Item(name: "Chocolate frosting", calories: 1000), 
Item(name: "Chocolate chip", calories: 1000) 


Implementamos os dois métodos de fonte de dados de uma tabela que 
vimos diversas vezes. O que retorna a quantidade de elementos: 


func tableView(tableView: UlTableView, 
numberOfRowsInSection section: Int) -> Int { 
return items.count 


E o que retorna o conteúdo de cada célula: 


func tableView(tableView: UlTableView, 
cellForRowAtIndexPath indexPath: NSIndexPath) 
-> UlTableViewCell 1 


let row - indexPath.row 

let item = items[ row ] 

var cell = UlTableViewCell (style: 
UITableViewCellStyle.Default,reuseIdentifier: nil) 

cell.textLabel.text - item.name 

return cell 
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Se rodarmos a aplicacáo, notamos que a tabela já reflete os dados do ar- 
ray, mas ainda temos alguns passos pela frente: sempre é bom entendermos 
melhor o que fizemos, melhoramos o código e continuamos. 


10.1 PROTOCOLOS DA API 


Mas por que não estamos escrevendo mais override func tableViewe, 
inclusive, se usarmos a palavra override o compilador reclama? Acontece 
que o protocolo UITableViewDataSource não fornece nenhuma imple- 
mentação do método, somente sua cara, sua interface (basicamente seu nome 
e seus parâmetros). 

Já ao herdar o UlTableViewCont roller, ele mesmo implementa o 
protocolo UITableViewDataSource e já escreve uma versão inicial des- 
ses métodos. Como no caso do U1TableViewController estamos so- 
brescrevendo um método já existente, usamos a palavra-chave override 
para deixar isso claro. Como somente puxamos a definição do proto- 
colo, não estamos sobrescrevendo nada. Você pode conferir o protocolo 
UlTableViewDataSource mantendo o command apertado e clicando em 


seu nome: 


protocol UlTableViewDataSource : NS0bjectProtocol 1 


func tableView(tableView: UlTableView, 
numberOfRowsInSection section: Int) -> Int 


func tableView(tableView: UlTableView, 
cellForRowAtIndexPath indexPath: NSIndexPath) 
-> UlTableViewCell 


// optional 


A primeira vez que vocé executa esse clique o Xcode pode dizer que 
não encontrou o que procurara ( Symbol not found). Em XCode, 
Preferences, Downloads você pode baixar a documentação do iOS. 

Repare que o UlTableViewDataSource possui dois métodos obriga- 
tórios, justamente os dois que definimos. 


141 


10.2. Seleção múltipla e Cell Accessory Casa do Código 





Testamos nossa aplicação e ela já mostra a tabela com os alimentos que 
entram em nossa refeição. Falta agora ser capaz de selecioná-los. 


10.2 SELEÇÃO MÚLTIPLA E CELL ACCESSORY 


Cada vez que selecionamos um item, gostaríamos de  marcá-lo 
com um check, algo que indique que vamos utilizá-lo na hora 
de criar nossa refeição. O  UITableViewCell fornece uma ma- 
neira de colocar informações extras em uma célula através da 





enum UITableViewCellAccessoryTypes. Por exemplo, o 





UITableViewCellAccessoryType.Checkmark adiciona uma marca de 





check enquanto o UITableViewCellAccessoryType.None é o padrão 
sem nenhuma marca. 





ENUM 


Uma enum é basicamente uma colecáo de valores limitados e pré- 
fixados. Veja no caso a seguir, onde definimos o tipo de erro como pos- 
sivelmente sendo FATAL ou WARNING: 


enum ErrorType { 
case FATAL 
case WARNING 


Enums podem ser utilizadas em programação funcional como um re- 
curso para garantir que todos os casos foram tratados, como quando fa- 
zemos pattern matching. Em Orientacáo a Objetos, é comum utilizarmos 
polimorfismo para obter resultados similares. 











Precisamos escrever o método que é invocado toda vez que o usuário tenta 
selecionar uma célula: 


func tableView(tableView: UlTableView, 
didSelectRowAtIndexPath indexPath: NSIndexPath) 1 
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Mas ao tentar escrever tableView percebemos que o editor não nos 
ajuda: esse método ainda não existe. Como assim? 

Se vamos implementar os comportamentos de delegate como fi- 
zemos aqui, temos que dizer que estamos suportando esse protocolo, o 
UlTableViewDelegat 





class ViewController: UlViewController, 
UlTableViewDataSource, UlTableViewDelegate 1 
// 


Agora sim o Xcode nos ajuda e podemos, dentro desse método, recuperar 
a célula que foi escolhida pelo usuário: 


func tableView(tableView: UITableView, 
didSelectRowAtIndexPath indexPath: NSIndexPath) 1 
let cell - tableView.cellForRowAtIndexPath(indexPath)! 


Marcamos colocando um marcador do tipo Checkmark: 


func tableView(tableView: UITableView, 
didSelectRowAtIndexPath indexPath: NSIndexPath) 1 
let cell - tableView.cellForRowAtIndexPath(indexPath) 
cell.accessoryType = UlTableViewCellAccessoryType.Checkmark 


O código não compila, a tipagem explícita escondeu que a ce11 é opci- 
onal. Vamos verificar se a célula foi encontrada para então marcá-la: 


func tableView(tableView: UITableView, 
didSelectRowAtIndexPath indexPath: NSIndexPath) 1 
let cell - tableView.cellForRowAtIndexPath(indexPath) 
if cell == nil { 
return 
+ 
cell!.accessoryType = UlTableViewCellAccessoryType.Checkmark 
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Rodamos nossa aplicação, selecionamos os elementos nos quais te- 
mos interesse e nada acontece.  Esquecemos de marcar que o nosso 
ViewController náo só é responsável pela fonte de dados (data source) 
de nossa tabela, mas também terá seus métodos invocados quando algo na ta- 
bela acontecer. Ele é nosso observer da tabela - nosso delegate. Voltamos 
à edição visual da TableView e agora arrastamos o delegate para nosso 
ViewController, como fizemos para o dataSource: 
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Testamos nossa aplicação e temos o resultado: 
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Name: 
Happiness: 


add 


Eggplant B... v 


Zucchini Muffin 
Cookie 

Coconut oil 
Chocolate f... v 


Chocolate chip 
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10.3 DESSELECIONANDO ELEMENTOS 


Opa, mas e se selecionei errado? Já era? Faltou implementarmos suporte 
para que quem está marcado possa ser desmarcado. Verificamos se nossa 
célula náo possui um checkmark e, se náo possuir, o adicionamos; caso 
possua, removemos. Vamos adicionar essa verificação no mesmo método a 
que atribuímos o Checkmark anteriormente: 


if (cell!.accessoryType == UlTableViewCellAccessoryType.None) 1 
cell! .accessoryType = UlTableViewCellAccessoryType.Checkmark 
} else { 
cell!.accessoryType = UITableViewCellAccessoryType .None 


10.4 ARMAZENANDO A SELEÇÃO 


Precisamos agora armazenar nossa seleção em algum lugar, para podermos 
criar nossa refeição na hora adequada. Podemos criar um array que mantém 
os números das linhas selecionadas: 


var selected = Array«Int» O 


func tableView(tableView: UlTableView, 
didSelectRowAtIndexPath indexPath: NSIndexPath) 1 
let cell = tableView.cellForRowAtIndexPath(indexPath)! 


if (cell.accessoryType == UlTableViewCellAccessoryType.None)f 
cell.accessoryType = 
UlTableViewCellAccessoryType.Checkmark 
selected.append(indexPath.row) 
} else { 
cell.accessoryType = UlTableViewCellAccessoryType.None 
// remove 


Mas um array de Int? Sério mesmo? Estamos trabalhando com objetos 
e agora brincamos com arrays de Int? Nosso array é de Item: 
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var selected = Array<Item>() 


func tableView(tableView: UlTableView, 
didSelectRowAtIndexPath indexPath: NSIndexPath) 1 
let cell - tableView.cellForRowAtIndexPath(indexPath)! 


if (cell.accessoryType == UlTableViewCellAccessoryType.None)f 
cell.accessoryType - 
UlTableViewCellAccessoryType.Checkmark 
selected.append(items [indexPath.row]) 
} else { 
cell.accessoryType = UlTableViewCellAccessoryType.None 
// remove 


Para testarmos, ao inicializarmos nosso Meal desejamos configurar seu 


meal. items e imprimi-lo: 


OIBAction func add() { 
if nameField == nil || happinessField == nil { 
return 


let name - nameField!.text 
let happiness - happinessField!.text.toInt() 


if happiness == nil 1 
return 


let meal = Meal(name: name, happiness: happiness) 
meal.items = selected 
printin( 

"eaten: N(meal.name) N(meal.happiness) N(meal.items)") 


if delegate == nil { 
return 
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delegate!.add(meal) 


if let navigation = self.navigationController { 
navigation.popViewControllerAnimated(true) 


Podemos testar nossa aplicação e ver o resultado: perfeito, ele imprime no 
log um array com o mesmo nümero de elementos que selecionei em minha 
tabela: 


3876877096 Portrait iPhone-Simple-Pad Default 
eaten: Zucchini Muffin 4 [eggplant brownie.Item, 
eggplant brownie.Item, eggplant brownie.Item, 
eggplant brownie.Item, eggplant brownie.Item] 


All Output + ur 


Falta removermos os desselecionados. Para isso, desejamos chamar a fun- 


ção remove de nosso array: 


selected.remove.... 


Mas não existe função que recebe o objeto a ser removido. Somente uma 
função que requer a posição a ser removida: 


selected.removeAtIndex(position) 


Logo, devemos primeiro achar a posição de nosso elemento em nosso 
array, usando a função find: 


let position = find(selected, items [indexPath.row]) 
selected.removeAtIndex(position) 
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Mas o código não compila. Acontece que a função find passa por todos 
os elementos de nosso array, verificando se cada um deles é igual ( ==) ao 
elemento que estamos procurando. Caso ele encontre o valor, ele retorna a 
posição, caso contrário, retorna nil. Uma implementação possível para essa 
função finda, que já existe, seria algo similar a: 


func find(elements:Array<Item>, toFind:Item) -> Int? | 
let max = elements.count - 1 
for i in O...max { 
if toFind == elements[i] 1 
return i 


} 


return nil 


Implementando o == 


Note que, para encontrarmos o elemento, usamos o operador =, mas 
como comparar dois Items? Precisamos de alguma maneira falar que 
esses itens são comparáveis, que temos como verificar se eles são iguais, 





Equatable. Portanto, fazemos nossa classe adotar o protocolo Equatable: 





class Item: Equatable { 
// code 


E implementar a função ==, que recebe dois itens e devolve um Boo1: 


func --(first:Item, second:Item) -> Bool 1 
return first.name -- second.name && 
first.calories -- second.calories 


Muito cuidado! A função == deve ser definida fora da classe: 


// Item.swift 


class Item: Equatable 1 
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// code 
+ 
func ==(first: Item, second:Item) -> Bool { 
return first.name == second.name && 
first.calories == second.calories 
} 


A implementação do == permite que o programador faça comparações 
entre objetos ao utilizar diversas partes da API fornecida pelo iOS. Além disso, 
outros programadores criam suas bibliotecas baseadas na existência de uma 
comparação compativel com a definição do ==. 


Agora sim, podemos verificar se nosso item existe dentro de nosso array 
utilizando a função find que já existe. Mas lembre-se: o find retorna um 
Optional, vamos verificar se encontramos a posição com o elemento que 
queremos remover, e aí o removemos: 


if let position = find(selected, items[indexPath.row]) 1 
selected.removeAtIndex (position) 


O código final do método vai permitir incluir ou remover um elemento 
selecionado em nosso array: 


func tableView(tableView: UITableView, 
didSelectRowAtIndexPath indexPath: NSIndexPath) { 
let cell = tableView.cellForRowAtIndexPath (indexPath) 
if cell = nil { 
return 
} 
if (cell!.accessoryType == 
UITableViewCellAccessoryType.None) { 
cell!.accessoryType = 
UlTableViewCellAccessoryType.Checkmark 
selected.append(items [indexPath.row]) 
} else ( 
cell!.accessoryType = UlTableViewCellAccessoryType.None 
if let position = find(selected, items [lindexPath.row]) 1 
selected.removeAtIndex(position) 
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Lembrando, nossa função de adicionar cria a refeição, seta os itens sele- 
cionados e os imprime: 


OIBAction func add() { 
if nameField == nil || happinessField == nil { 
return 


let name - nameField!.text 
let happiness - happinessField!.text.toInt() 


if happiness == nil 1 
return 


let meal = Meal(name: name, happiness: happiness) 
meal.items - selected 
printin( 

"eaten: N(meal.name) N(meal.happiness) N(meal.items)") 


if delegate == nil { 
return 


} 
delegate! .add (meal) 


if let navigation = self.navigationController { 
navigation.popViewControllerAnimated (true) 


Testamos nossa aplicação e agora somos capazes de comer cookies de 
óleo de coco, selecionar e desselecionar diversos itens e, ao adicionar a 
refeição final, temos no log o resultado com a impressão de quantos itens 
estavam em nossa refeição: 
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eaten: cookie de oleo de coco 5 
[eggplant brownie.Item, eggplant brownie.Item, eggplant brownie.Item] 


All Output é Wr 





10.5 RESUMO 


Vimos como podemos adicionar uma TableView em um controller 
existente e conectá-la ao seu data sourceeseu delegate usando o pat- 
tern Observer. Vimos também como receber eventos de seleção em nosso 





delegate e com isso utilizar aenum UITableViewCellAccessoryType 
para marcar as células como selecionadas. Armazenamos as células selecio- 
nadas e removemos as desselecionadas de um array que reflete tais escolhas 
do usuário. 

Para a remoção, foi importante conhecer mais de um protocolo bastante 
utilizado para usar com coleções: a capacidade de dois itens serem compa- 





rados com o ==, o protocolo Equatable. Utilizamos a função findea 
removeAtPosition para buscar e remover um elemento de nosso array. 


Por fim, usamos esse array logo após instanciar nossa refeição para pre- 
encher os campos que foram escolhidos. 
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Criando novos itens 


Chegou a hora de permitir ao usuário criar novos itens. Para isso, adicionare- 
mos um novo ViewController que representará um formulário. Ele terá 
O campo com o nome e o número de calorias desse item, além de um botáo 
de adicionar. Ao concluir a operação no formulário, devemos voltar para a 
tela de edição da refeição. 

Já conhecemos tudo isso, portanto veremos uma nova maneira de realizar 
o push, além de aproveitar a oportunidade para exercitar tudo o que fizemos 
anteriormente. Citamos anteriormente um dos problemas de manutenção de 
código ao lidar com diversos segues visuais, o código pode ficar cheio de 
cláusulas do tipo if, com uma complexidade alta. 

Uma outra alternativa, muito citada por desenvolvedores sêniores, está 
ligada à navegação entre telas de maneira programática. Da mesma maneira 
como fizemos um pop para desempilhar uma tela, utilizaremos um push 
(ou similar) para empilhar uma tela. 


Casa do Código 





Nosso primeiro passo é criar a representação visual de nosso 


viewcontroller, mas espere. Dessa vez nào puxaremos o controller 


para nosso storyboard. 








BOA PRÁTICA OU CODE SMELL? O STORYBOARD É UMA SOLU- 
ÇÃO DO BEM OU DO MAL? 


paradamente, ele também facilita o arrasta e solta como maneira de pro- 
gramar a iteracáo entre views. Por um lado, esse trabalho fica muito sim- 
ples; por outro, ele acaba forçando a criação de código com determinadas 
práticas que náo sáo consideradas as melhores (uma séries de ifs, por 
exemplo). 


tas telas que fica difícil manter todas as conexóes visualmente compre- 
ensíveis. 


equipe: quando duas pessoas o alteram de maneira incompatível. Será o 
trabalho de um deles de fazer o processo de merge na máo. Essa pessoa 
deverá alterar um xml que descreve as cenas, pois o editor visual nào 
será capaz de mostrar as diferenças. 


uso do storyboard pode náo comprometer a manutencáo de seu projeto. 
Aqui aprenderemos tanto a maneira visual com o storyboard quanto a 
programática com arquivos Xib (antigos nib). 


O Storyboard veio como alternativa para a criação de cada view se- 


Além disso, com o passar do tempo o storyboard pode ficar com tan- 


O maior problema do storyboard acontece quando trabalhamos em 


Como regra geral, em projetos mais simples, com menos views, o 








Vamos então isolar e criar um arquivo visual separado para esse nosso 


viewcontroller,o arquivo visual (nas versóes mais recentes do iOS) pos- 


sui a extensão XIB. Portanto, no grupo views, escolhemos o menu File, 


New, iOS, Source, Cocoa Touch Class, NewItemViewController, 
UIViewController, Also create XIB Filee Swift: 
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| Choose options for your new file: 





| Class: | NewltemViewController 


Subclass of: | UlViewController iv] 





[M Also create XIB file 





| iPhone y 








Language: | Swift + 

















Cancel | Previous | (Next 


Ele é criado no nosso grupo de views. Note que temos agora dois arqui- 


VOS, O XIB: 
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ounou 


5 + 


Manes menie a ean en 
Burton med jm actos memaga ta à arpat 
Miei tus T rapid 





Eo controller que já conhecemos: 





EBaaa4aomsoss 


|) ViewController.swift — Edited 


Running eggplant-brownie on iPhone 5 





4 >| É eggplant-brownie » [5] eggplant-brownie > |) ViewController.swift » No Selection 





v B eggplant-brownie 
2 targets, iOS SDK 8.1 


v [5 eggplant-brownie 
|») AppDelegate.swift 
|^; Main.storyboard 
sl Images.xcassets 
| LaunchScreen.xib 

» [7] Supporting Files 

» C eggplant-brownieTests 

> C Products 





// NiewController. swift 
4! eggplant-brownie 


// Created by Joviane Jardim on 14/10/14. 

// Copyright (c) 2014 Alura. All rights reserved. 
import UIKit 

class ViewController: UIViewController ( 


EEEBoosowrwmre 


override func viewDidLoad() 4 

14 super.viewDidLoad() 

15 // Do any additional setup after loading the view, typically from a nib. 
16 + 


18 override func didReceiveMemoryWarning() 1 
19 super. didReceiveMemoryWarnina() 
20 // Dispose of any resources that can be recreated. 


Como tanto o controller quanto o xib foram criados no mesmo di- 


retório, vamos mover o 
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anteriormente, movendo diretamente no diretório, removendo a referéncia e 
adicionando novamente pelo Xcode. 

Em nosso XIB, selecione sua View clicando no ícone branco à esquerda 
e escolha o tamanho do iPhone que estamos utilizando. Adicionamos agora 
os campos do formulário de um item, que são name e calories, e um 
botão de confirmar inclusão, chamado add: 
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Lembre-se de mudar o teclado do campo calories para Decimale 


colocar placeholder nos dois campos: sundubu e 10. 


Text Field Hide 

we Pan É 

Color mMEHH Default k 

+ Fort | System 14.0 Iê 
Alignment | = | ES Es ess 





Placeholder | 10 


Background | gro age 
Disabled | Disa! ickground Imagdii 
Border Style | ii = c q 


Clear Button | Never appears Ed 


[| Clear when editing begins 
Min Font Size | 17 |: 
Adjust to Fit 
Capitalization No ne 
Correction | Default i 
Spell Checking | Default ua 


Keyboard Type | Decimal Pad 
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No XIB, conferimos que ao selecionar o file owner sua identidade 
é o nosso NewItemViewController. Podemos até usar o assistant 
editor para conferir que a conexão ainda está feita: 


g< E > B3» B3». E Newite...roller.xib ) (7) Files Owner |< A >| ER @) A... 4 NewltemViewController.swift No Selection | + x 
Set the active scheme T 


// NewItemViewController.swift 
- // eggplant-brownie 


// Created by Guilherme Silveira on 11/18/14. 
// Copyright (c) 2014 alura. All rights 
Name: reserved. 

ú "4 


import UIKit 
lories: 
Ga ii class NewItemViewController: UIViewController í | 


override func viewDidLoad() 1 
add super.viewDidLoad() 


C // Do any additional setup after 
loading the view. 





Na nossa tela de adicionar nova refeicáo, dentro do storyboard, va- 
mos agora colocar o botão para conseguirmos fazer a navegação para esta 
tela nova. Poderíamos fazer a criacáo deste botáo de forma visual, arrastando 
o componente para a tela direto no storyboard, porém desta vez faremos 
programaticamente. 

Abrimos nosso ViewController. Dentro dele, sobrescrevemos o mé- 
todo viewDidLoad, onde criaremos um UIBarButtonItem. Para criar- 
mos um UlBarButtonItem, precisamos dizer qual o texto que queremos 
no botão ( title), qual o formato ( style), quem deve ser chamado ao cli- 
carmos nele ( target) e qual a ação que queremos executar neste objeto que 
for chamado ( action). 


override func viewDidLoad() 1 
let newlItemButton = UlBarButtonItem(title: "new item", 
style: UlBarButtonItemStyle.Plain, 
target: self, 
action: ????? 


Mas como podemos passar a chamada de um método para o botáo exe- 
cutar? Nào podemos chamar o método direto, pois desse modo ele será exe- 
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cutado no momento em que o chamarmos. Precisamos que o botáo chame 
o método. Para isto, criamos um Selector, passando como parámetro o 
nome do método que queremos que seja chamado: 


override func viewDidLoad() 1 
let newItemButton = UlBarButtonItem(title: "new item", 
style: UlBarButtonItemStyle.Plain, 
target: self, 
action: Selector("showNewItem")) 


Adicionamos também o botáo no lado direito de nosso Navigation 


Controller: 


override func viewDidLoad() 1 
let newItemButton = UlBarButtonItem(title: "new item", 
style: UlBarButtonItemStyle.Plain, 
target: self, 
action: Selector("showNewItem")) 
navigationItem.rightBarButtonlItem = newItemButton 


Rodamos a aplicação e podemos ver que o botão foi criado com sucesso: 
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Name: 
Happiness: 


add 
Eggplant Bro... 
Zucchini Muffin 
Cookie 
Coconut oil 


Chocolate fros... 


Chocolate chip 
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Criamos o código da funcáo que abrirá a tela de new item em nosso 
ViewController,imprimindo uma mensagem de teste: 


QIBAction func showNewItem() { 
println("new item") 


E testamos nossa aplicação, o botão aparece, e ao clicarmos nele vemos a 
mensagem de log. Perceba o poder de criar views programaticamente: você 
pode customizar todas as características de seu programa dinamicamente. 
Vale como regra geral desenhar o que é fixo via arrasta e solta (interface 
builder); e o que é customizado, dinâmico, acabamos fazendo programati- 
camente, como por exemplo um botão que só aparece quando o usuário está 
logado. 


11.1 PUSHANDO VIEWS PARA A PILHA PROGRAMATI- 
CAMENTE 


Agora estamos prontos para pegar nosso navegador e mostrar a tela 


NewItemViewController 


OIBAction func showNewItem() ( 
let newItem = 7??? 
if let navigation - navigationController 1 
navigation.pushViewController(newItem, animated: true) 


Precisamos criar nosso controller, mas lembre-se que estamos pro- 
gramando orientado a objetos e nosso NewItemViewController é uma 
classe: basta instanciá-la! 


OIBAction func showNewItem() + 
let newItem = NewItemViewController() 
if let navigation = navigationController 1 
navigation.pushViewController(newItem, animated: true) 


163 


111. Pushando views para a pilha programaticamente Casa do Código 





Testamos e, ao clicar no botáo, temos uma tela preta! 


override func viewDidLoad() 1 < ack 
let newItemButton = UIBarButtonItem(title 
style: UIBarButtonItemStyle.Plain, 
target: self, 
action: Selector("showNewItem")) 
navigationItem.rightBarButtonItem = newIt 


@IBAction func showNewItem() { 
let newItem = NewItemViewController() 
if let navigation = navigationController 
navigation.pushViewController(newItem 


) 
QGIBAction func add() ( 
if nameField == nil || happinessField == 
return 


let name = nameField!.text 
let happiness = happinessField!.text.toIn 
if happiness == nil ( 

return 


let meal = Meal(name: name, happiness: ha 
meal.items - selected 
println("eaten: N(meal.name) N(meal.happi 


if delegate == nil { 
return 
} 


delegate! .add(meal) 





O que acontece? Nós pedimos para instanciar o 
NewltemViewController mas ninguém falou qual arquivo xib era 
para ser usado. O xib é a nova versáo do arquivo nib, portanto, ao 
construirmos nosso NewItemViewController, dizemos qual arquivo de 
view queremos que ele leia: 


OIBAction func showNewItem() 1 
let newItem = NewItemViewController( 
nibName: "NewltemViewController", bundle: nil) 
if let navigation - navigationController 1 
navigation.pushViewController(newItem, animated: true) 
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Testamos a aplicacáo e, mesmo sem criar o segue, fomos capazes da ma- 
nipular a tela atual! Note que, se fosse importante passar algum argumento 
para nosso controller, bastaria chamar o construtor passando o argu- 
mento a mais (e criá-lo em nossa classe, claro), algo muito mais educado do 
que ficar setando propriedades após a construção. 


iOS Simulator - iPhone 6 - iPhone 6 / iOS 8.1 (12B411) 
Carrier = 6:09 PM = 


| < Back 


Name: 
Calories: 


add 


11.2 VOLTANDO DE UM PUSH PROGRAMÁTICO 


Precisamos agora voltar para a nossa tela anterior ao clicar no botão 
de confirmação. Já conhecemos o código do pop, logo, em nosso 
NewItemViewController.swift colocamos a função addNewItem. 
Além disso, definiremos as duas variáveis que nos ajudarão a ler os campos 
do item novo: 


class NewItemViewController: UlViewController 1 
OIBOutlet var nameField:UITextField? 
OIBOutlet var caloriesField:UITextField? 
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QIBAction func addNewItem() ( 
+ 


Usamos o arrasta da bolinha para conectarmos os outlets e a action com 
os campos de texto e o botão. 
DR oerte trm i mt terem eiie rane n com $ anga usa 


mga^omumos!o:sE «* hm BO Oveceee [jve E «+» es no 


CE mm ——— 





Mu Ve Centri sw 
Te Deae - Ser nec 
se Malata to Caso 
[AS - 





| 
i 
| 
1 





voe aao: - as Guga E 


Executamos o pop: 


OIBOutlet var nameField:UITextField? 
OIBOutlet var caloriesField:UITextField? 


QIBAction func addNewItem() ( 


if let navigation = navigationController { 
navigation.popViewControllerAnimated(true) 
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Agora lemos os valores dos campos e criamos um novo item: 


QIBAction func addNewItem() 1 
let name - nameField.text 
let calories = caloriesField.text 


let item = Item(name: name, calories: calories) 
if let navigation - navigationController 1 
navigation.popViewControllerAnimated(true) 


h 
} 
Algumas coisas não compilam, primeiro devemos verificar valores opci- 
onais: 


@IBAction func addNewItem() 1 
if nameField == nil || caloriesField == nil { 
return 


} 
let name = nameField!.text 
let calories = caloriesField!.text 


let item = Item(name: name, calories: calories) 
if let navigation = navigationController { 
navigation.popViewControllerAnimated(true) 


Eagora, caloriesaindaé String! Queremos converter para Double, 
procuramos o toDouble e vemos que ele não existe na classe de String 
padrão. Isso pois conversão de ponto decimal está ligada à localização e inter- 
nacionalização. No nosso caso, usaremos o padrão da linguagem Objective 
C, que já possuía uma String (NSSt ring) com o método de conversão. Cri- 
amos a instância de uma NSString e convertemos: 


QIBAction func addNewItem() 1 
if nameField == nil || caloriesField == nil { 
return 
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let name - nameField!.text 
let calories - 
NSString(string: caloriesField!.text).doubleValue 


let item - Item(name: name, calories: calories) 
if let navigation = navigationController 1 
navigation.popViewControllerAnimated (true) 


Testamos a aplicacáo e ela vai e vem, mas ainda náo notificamos a tela 
para a qual voltamos com o dado do novo item que acaba de ser adicionado. 
Está na hora de fazer nosso delegate. 


11.3 INVOCANDO UM DELEGATE DE FORMA PROGRA- 
MÁTICA 


Assim como fizemos antes, queremos notificar a tela que nos invocou de que 
o trabalho foi finalizado e temos um novo item para adicionar nela. Vamos 
criar o protocolo de nosso delegate,o AddAnItemDelegate: 


protocol AddAnItemDelegate 1 
func addNew(item:Item) 


E o implementamos, adotamos o AddAnItemDelegate em nosso 


ViewController: 


class ViewController: UlViewController, UITableViewDataSource, 
UlITableViewDelegate, AddAnItemDelegate { 


// 


func addNew(item: Item) 1 
items.append(item) 


// 
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Precisamos agora atualizar nossa tabela, mas onde está 
nossa tableView? Quando o controller era do tipo 
UlTableViewController era fácil: ele já vinha com uma tabela. 
Agora precisamos criar um novo outlet e conectá-lo a nossa tabela: 


OIBOutlet var tableView: UlTableView? 


func addNew(item: Item) 1 
items.append(item) 
if tableView == nil 1 
return 


+ 
tableView!.reloadData() 


Ná&o esquecemos de conectar o outlet usando o drag and drop. 

Como trabalhar agora no nosso NewItemViewController? Precisa- 
mos de um delegate lá, logo, como um bom cidadão, recebemo-lo em 
nosso inicializador: 


class NewItemViewController: UlViewController 1 


let delegate:AddAnItemDelegate? 
init(delegate:AddAnItemDelegate) 1 
self.delegate - delegate 


} 
// 


Mas o compilador reclama. Ao definirmos nosso inicializador, pre- 
cisamos invocar o inicializador de nossa classe pai. Com certeza! An- 
tes, invocávamos o construtor que recebia o nibName. O que era o 
nibName? O nome do arquivo que representa a view, a cena conectada 
aeste viewcontroller,entáo vamos invocá-lo logo após configurar nosso 


delegate: 
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class NewltemViewController: UlViewController ( 


let delegate:AddAnItemDelegate? 
init(delegate:AddAnItemDelegate) 1 

self.delegate - delegate 

super.init(nibName: "NewItemViewController", bundle: nil) 


} 
EA 


E novamente o compilador reclama: dessa vez ele pede a criação de 
um inicializador que receba um NSCoder. Acontece que a classe pai, 
UlViewController requer tal inicializador, portanto, vamos redefini-lo, 
simplesmente invocando o construtor de nosso pai: 


class NewltemViewController: UlViewController { 


let delegate:AddAnItemDelegate? 
init(delegate:AddAnItemDelegate) 1 

self.delegate - delegate 

super.init(nibName: "NewItemViewController", bundle: nil) 


required init(coder aDecoder: NSCoder) { 
super.init(coder: aDecoder) 


} 
// 
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NOMENCLATURA DE PARÁMETRO 


Mas que história é essa? Um parámetro com dois nomes? O nome 
interno do nosso parâmetro é aDecoder, enquanto quem invoca nosso 
inicializador usará o nome coder. 

O exemplo a seguir demonstra a utilizacáo de um nome interno e 
externo para deixar claro o valor que estamos referenciando: 


class User { 
init(name newName:String) 1 
println ("creating a NV(newNameV)") 


let guilherme - User(name: "guilherme") 











Claro, agora precisamos invocar o. delegate para adicionar um ele- 
mento: 


GIBAction func addNewItem() 1 
if nameField == nil || caloriesField == nil { 
return 


let name - nameField!.text 
let calories - 
NSString(string: caloriesField!.text).doubleValue 


let item - Item(name: name, calories: calories) 
if delegate == nil { 

return 
} 


delegate! .addNew (item) 


if let navigation = navigationController { 
navigation.popViewControllerAnimated (true) 
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Pronto. Na prática, o que acontece é que invocaremos o construtor em que 
estamos interessados, alterando nossa antiga chamada de inicialização para 
invocar o que recebe um delegate, portanto em nosso ViewController: 


OIBAction func showNewItem() 1 
let newltem = NewItemViewController(delegate: self) 
if let navigation = navigationController 1 
navigation.pushViewController(newItem, animated: true) 


Nosso código do viewController fica assim: 


import UIKit 


protocol AddAMealDelegate { 
func add(meal: Meal) 
} 
class ViewController: UlViewController, UlTableViewDataSource, 
UITableViewDelegate, AddAnItemDelegate { 


var items = [ Item(name: "Eggplant Brownie", calories: 10), 
Item(name: "Zucchini Muffin", calories: 10), 
Item(name: "Cookie", calories: 10), 
Item(name: "Coconut oil", calories: 500), 
Item(name: "Chocolate frosting", calories: 1000), 
Item(name: "Chocolate chip", calories: 1000) 


CIBOutlet var nameField: UITextField! 
CIBQutlet var happinessField: UITextField! 
var delegate:AddAMealDelegate? 

var selected = Array<Item>() 

OIBOutlet var tableView: UlTableView? 


func addNew(item: Item) 1 
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items.append(item) 

if tableView == nil 1 
return 

} 

tableView!.reloadData() 


func tableView(tableView: UITableView, 
numberOfRowsInSection section: Int) -> Int { 
return items.count 


func tableView(tableView: UlTableView, 
cellForRowAtIndexPath indexPath: NSIndexPath) 
-> UlTableViewCell 1 


let row = indexPath.row 

let item = items[ row ] 

var cell = UlTableViewCell (style: 
UlTableViewCellStyle.Default,reuseldentifier: nil) 

cell.textLabel.text = item.name 

return cell 


func tableView(tableView: UlTableView, 
didSelectRowAtIndexPath indexPath: NSIndexPath) { 
let cell = tableView.cellForRowAtIndexPath(indexPath) 
if cell == nil ( 
return 
h 
if (cell!.accessoryType -- 
UITableViewCellAccessoryType.None) 1 
cell!.accessoryType = 
UlTableViewCellAccessoryType.Checkmark 
selected.append(items [indexPath.row]) 
+ else 1 
cell!.accessoryType = 
UlTableViewCellAccessoryType.None 
if let position = 
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find(selected, items[indexPath.row]) 1 
selected.removeAtIndex(position) 


override func viewDidLoad() 1 
let newlItemButton = UlBarButtonItem(title: "new item", 
style: UIBarButtonItemStyle.Plain, 
target: self, 
action: Selector("showNewItem")) 
navigationlItem.rightBarButtonlItem = newItemButton 


OIBAction func showNewItem() ( 
let newltem = NewItemViewController(delegate: self) 
if let navigation = navigationController { 
navigation.pushViewController(newItem, animated:true) 


CIBAction func addO 1 
if nameField == nil || happinessField == nil { 
return 


let name - nameField!.text 
let happiness = happinessField!.text.toInt() 
if happiness == nil 1 

return 


let meal - Meal(name: name, happiness: happiness!) 
meal.items - selected 
printin( 

"eaten: N(meal.name) N(meal.happiness) N(meal.items)") 


if delegate == nil { 
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return 


delegate!.add(meal) 


if let navigation - self.navigationController 1 
navigation.popViewControllerAnimated(true) 


Enquanto isso, nosso NewItemViewController 


import UIKit 


protocol AddAnItemDelegate 1 
func addNew(item:Item) 
} 
class NewItemViewController: UlViewController { 
let delegate:AddAnItemDelegate? 
init(delegate:AddAnItemDelegate) 1 
self.delegate - delegate 
super.init(nibName: "NewltemViewController", bundle: nil) 
} 
required init(coder aDecoder: NSCoder) { 
super.init(coder: aDecoder) 


OIBOutlet var nameField:UITextField? 
OIBOutlet var caloriesField:UITextField? 


OGIBAction func addNewItem() 1 
if nameField == nil || caloriesField == nil 1 
return 
} 
let name = nameField!.text 
let calories = 
NSString(string: caloriesField!.text).doubleValue 
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let item - Item(name: name, calories: calories) 


if delegate == nil { 
return 


Y 
delegate!.addNew(item) 


if let navigation = navigationController 1 
navigation.popViewControllerAnimated(true) 


Testamos nossa aplicação e, à medida que adicionamos novos itens, já os 
temos na nossa lista de itens a serem utilizados para a criação de uma refeição. 
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iOS Si 


Carrier 


€ Back 


Name: 
Happiness: 


add 
Eggplant Bro... 
Zucchini Muffin 
Cookie 
Coconut oil 
Chocolate fros... 
Chocolate chip 


Cheesecake 
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11.4 RESUMO 


Vimos neste capítulo como criar um XIB, uma view de um 
ViewController que pode ser reutilizada mais facilmente, e vimos 
como definir o que nosso construtor recebe durante sua construção. Revi- 
samos a criacáo de um formulário, o push eo pop programático, além do 
uso deum delegate para notificar nosso observer de uma tarefa executada 
em nossa tela. 
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CAPÍTULO 12 


Mostrando os detalhes de uma 
refeicáo com Long press 


Mas após adicionada, como conferimos os detalhes de cada refeição? Quais 
os itens e suas respectivas calorias? 

Para fazermos isso, usaremos um recurso que frequentemente aparece em 
aplicativos iOS, o Long Press: ao segurarmos o clique em uma linha de 
nossa tabela, queremos visualizar a tela de detalhes. 

Precisamos primeiramente dizer que nossa célula consegue reconhecer 
este tipo de interação e qual ação deve ocorrer quando for identificado o 
evento de Long Press. O responsável por fazer esse reconhecimento é o 
“elemento visual reconhecedor de movimento de manter apertado”, literal- 
mente o UlLongPressGestureRecognizer. Lembra quando criamos 
nossa célula no MealsTableViewController? 
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override func tableView(tableView: UlTableView, 


cellForRowAtIndexPath indexPath: NSIndexPath) -> 
UITableViewCell { 

let row - indexPath.row 

let meal = meals[ row ] 


var cell = UITableViewCell( 
Style: UlTableViewCellStyle.Default, 
reuseldentifier: nil) 
cell.textLabel.text - meal.name 


return cell 


Instanciamos o UILongPressGestureRecognizer e o adicionamos 


à nossa célula: 


override func tableView(tableView: UlTableView, 


cellForRowAtIndexPath 

indexPath: NSIndexPath) -> UlTableViewCell { 
Peis 
let longPress = 

UILongPressGestureRecognizer(/* parameters */) 
cell.addGestureRecognizer (longPress) 
return cell 


Mas qual será o método executado quando o usuário mantiver o dedo 


pressionado nesta célula? De alguma maneira, devemos falar nosso alvo, o 


objeto a ser notificado ( target) e o método a ser invocado ( action). Já 


conhecemos esse par, o objeto eo Selector: 


override func tableView(tableView: UlTableView, 
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cellForRowAtIndexPath indexPath: NSIndexPath) -> 
UITableViewCell 1 

//... 

let longPress = UlLongPressGestureRecognizer(target: self, 
action: Selector("showDetails")) 

cell.addGestureRecognizer (longPress) 

return cell 
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Criamos o método para mostrar mais detalhes da refeição: 


func showDetails()( 
} 


Mas como saberemos qual refeição foi selecionada? Felizmente, o pró- 
prio UILongPressGestureRecognizer guarda a informação sobre em 
qual view o evento ocorreu, temos apenas que pedir o reconhecedor por 
parâmetro: 


func showDetails(recognizer: UILongPressGestureRecognizer){ 


Só precisamos agora indicar ao LongPressGestureRecognizer que 
queremos recebé-lo no momento em que o método showDetails for in- 
vocado. Para representarmos que queremos receber um parámetro no nosso 
Selector, colocamos ":" (dois pontos) no final do nome do método. Isto 
é heranca do Objective-C, onde indicávamos a passagem de parámetros com 
OS ":", 


override func tableView(tableView: UlTableView, 

cellForRowAtIndexPath indexPath: NSIndexPath) -> 
UITableViewCell { 

Pl is 

let longPress - UlLongPressGestureRecognizer(target: self, 
action: Selector("showDetails:")) 

cell.addGestureRecognizer (longPress) 

return cell 


Vamos mostrar os detalhes de nossa refeição, mas em qual momento que- 
remos que eles apareçam? Quando o evento de long press começou! Por- 
tanto, verificamos o estado e colocamos um println para sabermos que 
funcionou. 


func showDetails(recognizer: UlLongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
println("Long press") 
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Vamos rodar. Ao efetuarmos o Long Press, clicando e segurando a 
linha da tabela da qual queremos ver mais detalhes, o log mostra a mensagem: 


Long press 





All Output 7 Ur E 


12.1 RECUPERANDO ONDE OCORREU UM EVENTO DE 
LONG PRESS 
Agora temos que recuperar qual a célula em que ocorreu o Long Presseo 


seu conteúdo. Para isso, primeiro extraímos do recognizer quala viewà 
qual ele estava atrelado, nossa célula: 


func showDetails(recognizer: UILongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view 


println("Long press") 


Agora que temos a célula, podemos buscar o índice dela em nossa 
tableView através do método indexPathForCell: 


func showDetails(recognizer: UlLongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view 
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let indexPath - tableView.indexPathForCell(cell) 


println("Long press") 


Mas, ao digitar a chamada para o método, o Xcode náo consegue re- 
conhecer o método pois a view náo é nosso UITableViewCell, afinal, 
um UILongPressGestureRecognizer pode ser aplicado para qualquer 
tipo de UIView! Como nós, desenvolvedores, temos certeza de que temos 
uma célula aí dentro referenciada pela view, podemos fazer o cast para 
UITableViewCell: 


func showDetails(recognizer: UlLongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view as UlTableViewCell 
let indexPath - tableView.indexPathForCell(cell) 


println("Long press") 
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CODE SMELL: CAST 


Sempre que fazemos um cast estamos dizendo que nós, como desen- 
volvedores, sabemos o que está acontecendo, e o compilador náo. Se isso 
acontece, estamos correndo risco. O compilador existe para garantir di- 
versas coisas, dentre elas, que náo acessamos algo pensando que é outra 
coisa. O casting permite cometer esse erro (e estourar a aplicação). 

Como fugir do cast? Em casos similares como esse, caso o 
UILongPressGestureRecognizer fosse genérico mas permitisse di- 
zer o tipo de classe para o qual fosse aplicado, definiríamos em sua cria- 
ção que ele só pode trabalhar com UITableViewCell e teríamos cer- 
teza de que as views onde ele ocorreu são do tipo UITableViewCell. 
Esse tipo de comportamento pode ser alcançado com o uso de generics, 
mas como o mesmo é um componente da biblioteca padráo do iOS, nào 
temos como alterar o código para tal benefício de compilacáo. 











Coma celleuma tableView em mãos, somos capazes de descobrir 
em qual linha ocorreu a ação, mas repare que a IDE adiciona um ? de opci- 
onal: 


func showDetails(recognizer: UlLongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view as UlTableViewCell 
let indexPath - tableView.indexPathForCell(cell) 
let row - indexPath?.row 


println("Long press") 


Náo queremos opcional e correr risco, logo, if nele: 


func showDetails(recognizer: UlLongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view as UlTableViewCell 
let indexPath - tableView.indexPathForCell(cell) 
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if indexPath == nil { 
return 


} 


let row = indexPath! .row 


println("Long press") 


} 
} 
Portanto, podemos extrair a refeição que foi clicada, buscando-a em nosso 
array: 


func showDetails(recognizer: UILongPressGestureRecognizer){ 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view as UlTableViewCell 
let indexPath - tableView.indexPathForCell(cell) 
if indexPath == nil ( 
return 
h 
let row - indexPath!.row 
let meal - meals[ row ] 


println("Long press") 


Vamos mudar o print In para mostrar o nome e o nível de felicidade da 


refeicáo selecionada: 


func showDetails(recognizer: UlLongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view as UlTableViewCell 
let indexPath = tableView.indexPathForCell(cell) 
if indexPath == nil ( 
return 
h 
let row - indexPath!.row 
let meal - meals[ row ] 


println("meal: N(meal.name) N(meal.happiness)") 
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Rodamos e agora o log mostra a refeição selecionada ao efetuarmos o 


Long Press: 


meal: Eggplant brownie 5 


All Output + LR OE L| 





Estamos prontos para nosso próximo passo: mostrar os dados na tela atra- 
vés de um outro Controller. 


12.2 MOSTRANDO OS DETALHES EM UM ALERTA 


Para mostrarmos os detalhes de uma refeição selecionada, criaremos um 
alerta, um UIAlertController,ouseja, um popup com os dados que que- 
remos mostrar: 


func showDetails(recognizer: UILongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell = recognizer.view as UlTableViewCell 
let indexPath - tableView.indexPathForCell(cell) 
if indexPath -- nil ( 
return 
} 
let row = indexPath! .row 
let meal = meals[ row ] 


let details = UIAlertController(/* parameters */) 
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Quais parámetros devemos passar ao nosso alerta? Primeiro, o título com 


o nome da refeicáo e a mensagem com o nível de felicidade: 


func showDetails(recognizer: UlLongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view as UlTableViewCell 
let indexPath = tableView.indexPathForCell(cell) 
if indexPath == nil ( 
return 
} 
let row = indexPath!.row 
let meal = meals[ row ] 


let details = UlAlertController(title: meal.name, 
message: "Happiness: \(meal.happiness)", 
/* extra parameter */ ) 


Mas devemos falar também qual o tipo de alerta que desejamos mostrar, 


o estilo tradicional: 


func showDetails(recognizer: UILongPressGestureRecognizer){ 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view as UlTableViewCell 
let indexPath - tableView.indexPathForCell(cell) 
if indexPath == nil 1 
return 
h 
let row - indexPath!.row 
let meal - meals[ row ] 


let details = UlAlertController(title: meal.name, 


message: "Happiness: N(meal.happiness)", 
preferredStyle: UlAlertControllerStyle.Alert) 


Por fim, pedimos para mostrar nosso controller de alerta através do 
método presentViewController,animado. Náo utilizamos o ültimo pa- 
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rámetro para esse método, entáo o desejamos vazio: 


func showDetails(recognizer: UILongPressGestureRecognizer)í 
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if recognizer.state == UlGestureRecognizerState.Began { 


let cell = recognizer.view as UlTableViewCell 
let indexPath = tableView. indexPathForCell (cell) 
if indexPath == nil 1 

return 
} 
let row = indexPath!.row 
let meal = meals[ row ] 


let details = UlAlertController(title: meal.name, 
message: "Happiness: N(meal.happiness)", 
preferredStyle: UlAlertControllerStyle.Alert) 
presentViewController( 
details, animated: true, completion: nil) 
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Eggplant brownie 
Happiness: 5 
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Mas e como fechamos os detalhes? Precisamos avisar nossa tela de que 
queremos voltar para a tela anterior e remover a tela atual. 





MODAL 


Repare que, anteriormente, quando precisamos apresentar uma nova 
tela, utilizamos a navegação tradicional, com push para mostrar a tela e 
pop para fechar. Fizemos isso pois queríamos manter sempre o histórico 
de navegacáo, por quais telas passamos e para onde voltaríamos. No caso 
do ActionController, queremos apenas mostrar o popup, sem pre- 
cisar interferir no fluxo de navegação anterior, portanto este popup não 
precisa entrar na pilha de navegação. Para estes casos, fazemos a navega- 
ção de modo Modal, apresentando a tela por cima da anterior, através 
dos método presentViewCont roller (mostrar). A responsabilidade 
de tirar a tela apresentada fica para quem chamou o modal, isto é, nós te- 
mos que lembrar de adicionar a Action para permitir fechar o modal. 











Desejamos adicionar um botão “OK” que permita fechar nossa tela. Como 
fizemos anteriormente, vamos instanciá-lo passando diversos parâmetros, 
entre os quais o título ( Ok) e o estilo (Cancel): 


let details = UlAlertController(title: meal .name, 
message: "Happiness: N(meal .happiness)", 
preferredStyle: UlAlertControllerStyle.Alert) 
let ok = UlAlertAction(title: "Ok", 
style: UlAlertActionStyle.Cancel, 
/* extra parameters */) 


presentViewController (details, animated: true, completion: nil) 


Em seguida, adicionamos o botão de cancelar em nosso detalhamento: 


let details = UlAlertController(title: meal .name, 
message: "Happiness: N(meal.happiness)", 
preferredStyle: UlAlertControllerStyle.Alert) 
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let ok = UlAlertAction(title: "Ok", 
style: UlAlertActionStyle.Cancel, 
/* extra parameters */) 
details.addAction(ok) 
presentViewController(details, animated: true, completion: nil) 


Mas temos ainda que falar que náo queremos executar nada ao fechar 
nosso diálogo, passando nil como parámetro: 


let details - UlAlertController(title: meal.name, 
message: "Happiness: N(meal.happiness)", 
preferredStyle: UlAlertControllerStyle.Alert) 
let ok = UlAlertAction(title: "Ok", 
Style: UIAlertActionStyle.Cancel, 
handler: nil) 
details.addAction(ok) 
presentViewController(details, animated: true, completion: nil) 


Rodamos e agora podemos voltar para a lista através do botão de Ok do 
nosso popup: 


191 


12.2. Mostrando os detalhes em um alerta Casa do Código 





Eggplant brownie 
Happiness: 5 


Ok 
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12.3 MOSTRANDO OS DETALHES DOS ITENS 


Agora que já conseguimos mostrar os dados básicos de uma refeição, vamos 
acrescentar também os itens que aquela refeição tem. Pegamos todos os itens 
que temos na refeição e concatenamos na mensagem do popup. Como uma 
refeição pode ter mais do que um item, usamos um for para efetuarmos a 


concatenação. Acrescentamos no método showDetails: 


var message = "Happiness: N(meal.happiness)" 


for item in meal.items { 
message += "Nn * N(item.name) - calories: N(item.calories)" 


h 

let details = UlAlertController(title: meal.name, 
message: message, 
preferredStyle: UlAlertControllerStyle.Alert) 


Bacana, temos agora todo o detalhamento de nossas refeições mas nosso 
método ficou com responsabilidades demais. Além de buscar a célula seleci- 
onada, ainda precisa ser responsável por imprimir as informações e também 
mostrar o popup com o detalhamento. Saber as informações de detalhes é res- 
ponsabilidade da própria refeição, logo, vamos extrair este comportamento 
para a classe Meal: 


class Meal { 


// 


func details() -> String { 
var message = "Happiness: N(self.happiness)" 


for item in self.items { 
message 
+= "Nn * N(item.name) - calories: N(item.calories)" 


return message 
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Agora só precisamos utilizar este novo método dentro do showDetails, 
que ficará da seguinte forma: 


func showDetails(recognizer: UILongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view as UlTableViewCell 
let indexPath - tableView.indexPathForCell(cell) 
if indexPath == nil ( 
return 


} 
let row = indexPath!.row 
let meal = meals[ row ] 


let details = UlAlertController(title: meal.name, 
message: meal.details(), 
preferredStyle: UlAlertControllerStyle.Alert) 


let ok - UlAlertAction(title: "Ok", 
Style: UIAlertActionStyle.Cancel, 
handler: nil) 

details.addAction(ok) 


presentViewController( 
details, animated: true, completion: nil) 


Nosso controller náo precisa mais saber como fazer para imprimir as 
refeicóes. A ünica coisa de que ele precisa é invocar o método details da 
classe Meal. Esta ideia de não precisar conhecer detalhes da implementação 
para conseguir executar a ação desejada é um conceito muito importante da 
Orientação a Objetos chamado de encapsulamento. 

Rodamos e criamos um novo item chamado cheese com 100 ca- 
lorias. Adicionamo-lo junto do cookie em uma nova refeição chamada 
cheesecake. Efetuamos o Long Press e temos o resultado: 
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Cheesecake 
Happiness: 5 
* Cookie - calories: 10.0 
* Cheese - calories: 100.0 


Ok 
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12.4 RESUMO 


Vimos neste capítulo como podemos responder a um evento de clique longo ( 
Long Press)ecomo podemos mostrar um popup personalizado utilizando 
um UIAlertController. Também vimos que podemos navegar para ou- 
tras telas sem utilizar push, através do modo Moda1 e, no final, melhoramos 
nosso código, separando as responsabilidades e encapsulando as funcionali- 
dades específicas em seus devidos lugares. 
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CAPÍTULO 13 


Alerta: optionals e erros 


Ainda temos muitos códigos espalhados que fazem verificações para detectar 
se as variáveis estão com valores válidos antes de explodir a aplicação. 

O uso de Optionals em Swift é muito interessante, mas como toda re- 
ferência que pode ser nula, seu uso é perigoso. 

Vejamos o que podemos fazer agora para melhorar todos os ifs que 
retornam de nossas funções, e tratar os erros desconhecidos do sistema de 
uma maneira uniforme, de modo que o usuário entenda o que aconteceu. 

Primeiro, vamos à nossa tela de nova refeição, à qual adicionamos um 
novo item, no ViewController. Repare que, ao adicionarmos um novo 


item em nosso array, utilizamos o código a seguir: 


func addNew(item: Item) 1 
items.append(item) 
if tableView == nil 1 
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return 


+ 
tableView!.reloadData() 


Qual o perigo de usar um !? É que sempre que usamos um ! estamos 
dizendo ao compilador que sabemos o que estamos fazendo, e que a apli- 
cacáo vai parar se der algum problema de acesso. O acesso a uma variável 
Optional com ! éo equivalente ao acesso de objetos tradicionalmente feito 
em outras linguagens como Java. Se a referência for nula, a aplicação crasheia. 
Perigoso. Como não queremos isso, prometi a vocês não digitar jamais um 
!, mas acabamos usando-o aqui. 

Apesar disso, como bons programadores, devemos nos proteger em todo 
o nosso programa. Sempre antes de usar uma referência opcional, verificamos 
seu valor com if. Qual o problema do !, então? É que dependemos de 
nós mesmos, temos que lembrar de usar o if, se esquecermos, ou se nos 
enganarmos, a aplicação crasheia. 

Não queremos depender de algo tão frágil quanto nossa própria memória. 
Por isso, vamos evitar o ! sempre que possível: não queremos que a aplicação 
crasheie e não queremos correr o risco de esquecer nosso if. 

A solução? Só quero chamar o método reloadData se a variável 
tableView foi definida adequadamente, caso contrário não chame o mé- 
todo: 


func addNew(item: Item) 1 
items.append(item) 
tableView?.reloadData() 


O próprio compilador adiciona o if. Só executamos o método 
reloadData se a referéncia para a tabela for válida. Como código, é bem 
menos digitação, e como bons programadores, nosso objetivo de vida é digi- 
tar o mínimo possível, certo? Errado. Náo somos pagos para digitar o mínimo 
de caracteres, somos pagos por um produto de qualidade. 

O código anterior possui um perigo tremendo: se a variável estiver de- 
finida, tudo funciona como o esperado. Se náo, ele adiciona no array e nào 
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atualiza a tabela. Inocente? Pensemos com mais cuidado: o usuário final re- 
aliza uma tarefa como efetuar uma transferéncia: 


func transfer(from:Account, to:Account, value:Double) 1 
from.withdraw (amount) 
to.deposit (amount) 
navigationController! .popViewControllerAnimated(true) 


A ünica linha que nào funcionou é a que atualiza a mensagem na tela. 
Nessa versão, a aplicação crasheia e o usuário fica sem saber o que aconteceu. 
Já na versáo adiante, dependemos de o desenvolvedor se lembrar de fazer um 
Xf: 


func transfer(from:Account, to:Account, value:Double) 1 
from.withdraw (amount) 
to.deposit (amount) 
if navigationController == nil { 
// display alert 
return 


h 


navigationController!.popViewControllerAnimated(true) 


Mudamos para o optional chaining,isto é, usando a ? no lugar da 


func transfer(from:Account, to:Account, value:Double) 1 
from.withdraw (amount) 
to.deposit (amount) 
navigationController?.popViewControllerAnimated(true) 


A linha novamente náo funciona, o pop náo é feito, mas a transferência 
já foi efetuada. O que o usuário final faz, uma vez que nào sabe que algo deu 
errado? Ele transfere novamente. Caboom. A aplicação náo crasheia, mas ele 
efetua duas vezes uma coisa que só queria efetuar uma. 

Optional chaining é bonito mas tão ou mais perigoso que um crash 
de sua aplicação. Pior ainda se existe lógica após uma chamada de optional 
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chaining! Ele potencializa o caso de esquecimento do desenvolvedor, que 
como qualquer ser humano está fadado ao erro. 


13.1 BOA PRÁTICA: EVITE OPTIONAL, GARANTA TUDO 
COM IF LET 


Mas se ambos sáo ruins, qual minha alternativa? Jamais utilizar o ! sob qual- 
quer circunstância e jamais usar o ? para optional chaining. São pala- 
vras fortes, mas vale como quase sempre. Quase sempre vale a pena garantir 
que sua aplicação náo terá um crash no futuro. 

Só tenho variáveis obrigatórias ou opcionais definidas como ?, que é o 
que forçamos até agora. Como extrair o valor de uma delas? Usando o if 
let. Se não usamos optional chaining nem !, a única maneira de 
extrair o valor é com o if let: não tem como o desenvolvedor esquecer o 
if! 
func addNew(item: Item) { 

items .append(item) 


if let table = tableView { 
table.reloadData() 


Será que Swift seria uma linguagem ainda mais segura se não existissem 
o optional chainingeo !? Talvez, só o tempo dirá. 

Claro, um desenvolvedor preguiçoso, que prefere digitar menos e correr 
mais risco, pode argumentar que assim estamos digitando mais. É verdade... 
E daí? 


13.2 TRATANDO O ERRO COM UMA MENSAGEM NOVA- 
MENTE 


Vamos aplicar a regra que definimos dos optionals e tratar nossos erros. 
Começamos com a função que mencionamos. Quando o usuário adiciona 


um item, caso um erro aconteça, desejamos mostrar alguma mensagem de 
erro: 
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func addNew(item: Item) 1 
items.append(item) 
if let table = tableView { 
table.reloadData() 
+ else 1 
let alert = UlAlertController(title: "Sorry", 
message: "Unexpected error.", 
preferredStyle: UlAlertControllerStyle.Alert) 
let ok = UlAlertAction(title: "Understood", 
style: UlAlertActionStyle.Cancel, 
handler: nil) 
alert .addAction(ok) 
presentViewController( 
alert, animated: true, completion: nil) 


Para testarmos, precisamos desconectar nosso outlet, simulando um erro 
de configuração ou de runtime. Vamos ao nosso storyboard, selecionamos 
O UITableView da tela de nova refeição e, na parte da direita, onde temos 
O connections inspector, removemos o outlet clicando no x 


Referencing Outlets 


( tableView OR View Controller — (8) 


Mew Referencing Outlet Q 


Agora testamos a aplicação e temos a mensagem de erro: 
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iOS Simulator - iPhone 6 - iPhone 6 / iOS 8.1 (12B411) 








noz O E O 




















New Referencing Outlet O 
rencing Outlet Collections 
New Referancing Outlet Collection O 








Sorry 


Unexpected error. 


Understood 


13.3 BoA PRÁTICA: MENSAGENS DE ERRO DESCRITI- 
VAS 


Apesar do erro, a mensagem pode deixar o usuário confuso. Na situacáo que 
vimos, ela indica que algo inesperado aconteceu, mas o qué? E como o usuário 
deve se sentir em relação a isso? Qual seu próximo passo? 

Escolha suas mensagens de erro de forma bastante descritiva. Aqui, ape- 
sar de náo ser possível atualizar a tabela, conseguimos adicionar o elemento 
em nosso array, por exemplo um sundubu. Ao clicarmos em back, vemos 
que o resultado havia sido positivo, mesmo tendo sido mostrada a mensagem 
de erro: 
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iOS Simulator - iPhone 6 - iPhone 6 / iOS 8.1 (12B411) 


Carrier = 4:18 AM 
€ Back 
Name 
Happiness 
Add 


Eggplant Brownie 
Zucchini Muffin 
Cookie 

Coconut oil 
Chocolate frosting 
Chocolate chip 


sundubu 


new item 
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Portanto, mudamos nossa mensagem de erro para indicar essa situação 
claramente, dizendo que o item foi adicionado com sucesso mas algum erro 


inesperado ocorreu: 


func addNew(item: Item) 1 
items.append(item) 
if let table = tableView { 
table.reloadData() 
+ else { 
let alert - UlAlertController(title: "Sorry", 
message: "Unexpected error, but the item was added.", 
preferredStyle: UlAlertControllerStyle.Alert) 
let ok - UlAlertAction(title: "Understood", 
Style: UIAlertActionStyle.Cancel, 
handler: nil) 
alert.addAction(ok) 
presentViewController( 
alert, animated: true, completion: nil) 


13.4  REFATORACÁO: TRATANDO DIVERSOS ERROS 


Só de imaginar o código que colocaremos aqui já bate uma preguiça... vai ficar 
táo repetitivo. Nào só isso, nosso controller já tem tantas responsabilidades 
distintas; devemos bater na tecla de uma classe, uma responsabilidade. Se- 
ria tão bom se pudéssemos resumir essa responsabilidade em uma invocação 
simples de mostrar mensagem de alerta: 


func addNew(item: Item) 1 
items.append(item) 
if let table = tableView { 
table.reloadData() 
+ else { 
Alert().show("Unexpected error, but the item was added.") 
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Se queremos simplificar, podemos. Extraímos o código de mostrar um 
alert de erro para uma classe específica em nosso grupo views: 


class Alert 1 
func show(message:String) { 

let details = UlAlertController(title: "Sorry", 
message: message, 
preferredStyle: UlAlertControllerStyle.Alert) 

let cancel - UlAlertAction(title: "Understood", 
style: UlAlertActionStyle.Cancel, 
handler: nil) 

details.addAction(cancel) 

presentViewController( 
details, animated: true, completion: nil) 


O código ainda nào compila. Primeiro devemos importar UIKit, pois 
usamos diversos componentes de UI nele: 


import UIKit 


Agora temos um ültimo erro de compilacáo, uma vez que o método 
presentViewController náo existe por aqui. Ele está definido em 
um UIViewController. Precisamos de nosso controller aqui? Ótimo, 
recebemo-lo na inicialização, afinal, somos good citizens: 


class Alert { 
let controller:UIViewController 
init(controller:UIViewController) { 
self.controller = controller 


func show(message:String) { 
let details - UlAlertController(title: "Sorry", 
message: message, 
preferredStyle: UlAlertControllerStyle.Alert) 
let cancel = UlAlertAction(title: "Understood", 
Style: UlAlertActionStyle.Cancel, 
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handler: nil) 
details.addAction(cancel) 
controller.presentViewController(details, 
animated: true, completion: nil) 


Ao criarmos nosso alerta, devemos passar o controller: 


func addNew(item: Item) 1 
items.append(item) 
if let table = tableView 1 
table.reloadData() 
) else { 
Alert(controller: self).show( 
"Unexpected error, but the item was added.") 


Bonito. Testamos agora e, após toda essa refatoração para simplificar 
nosso código final, continuamos com nossa mensagem de erro funcionando. 
O objetivo de toda refatoração é extrair uma parte suja, simplificando-a de 
alguma maneira e ao mesmo tempo facilitando a utilização daquela parte por 
quem já a utilizava. É o que fizemos aqui: isolamos uma responsabilidade e 
simplificamos o código de quem precisa invocá-la. 


13.5 PARÁMETROS DEFAULT 


Muitas vezes utilizaremos a mesma mensagem de erro. Nesses casos, pode- 
mos utilizar um valor padráo para nosso parámetro: 


func show(message:String = "Unexpected error.") { 
let details - UlAlertController(title: "Sorry", 
message: message, 
preferredStyle: UlAlertControllerStyle.Alert) 
let cancel - UlAlertAction(title: "Understood", 
style: UlAlertActionStyle.Cancel, 
handler: nil) 
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details.addAction(cancel) 
presentViewController( 
details, animated: true, completion: nil) 


Agora poderíamos invocá-lo sem parámetros: 


func addNew(item: Item) 1 
items.append(item) 
if let table = tableView 1 
table.reloadData() 
+ else 1 
Alert(controller: self).show() 


Mas se desejamos manter a mensagem customizada de antes, agora que 
utilizamos valores de£ault somos obrigados a dizer qual parámetro esta- 
mos repassando: 


func addNew(item: Item) 1 
items.append(item) 
if let table = tableView 1 
table.reloadData() 
+ else 1 
Alert(controller: self).show(message: 
"Unexpected error, but the item was added.") 
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CODE SMELL: DIVERSOS PARÁMETROS COM VALOR PADRÃO 


Por mais que pareça interessante utilizar diversos parâmetros com va- 
lor padráo, temos alguns cuidados a tomar. Primeiro, assim como em di- 
versas outras linguagens, os parámetros opcionais sáo sempre os ültimos 
de uma funcáo. Segundo, um nümero grande de parámetros opcionais 
em geral indica uma grande quantidade de possibilidades de resultados 
diferentes para uma invocacáo à sua funcáo e, se esse for o caso, a com- 
plexidade do método também pode estar alta. 

Tome cuidado com parámetros opcionais: se ele indica uma alta com- 
plexidade (ciclomática) do seu método, refatore. Se ele indica somente 
números ou Strings padrão que não entram em cláusulas condicionais 
(como ifs, fors e switchs), menos problemas. 

Uma das maneiras de refatorar um código com muitos parámetros 
opcionais (principalmente um construtor com tais características) é a 
utilizacáo do design pattern Builder. 











13.6 BOA PRÁTICA: SINGLE RESPONSIBILITY PRINCI- 
PLE, PRINCÍPIO DE RESPONSABILIDADE ÚNICA 


É considerada uma boa prática a utilizacáo de uma única responsabilidade 
por unidade de código. Em Orientação a Objetos, é comum que os métodos 
estejam agrupados em uma classe de acordo com uma determinada funcio- 
nalidade. Por exemplo, os métodos de entrada e saída devem ficar em uma 
classe diferente que as de interface com o usuário. É por isso mesmo que cri- 
amos esse isolamento básico da classe Alert do resto de nosso programa. 

Agora podemos aplicar nosso Alert a outras partes do código. Vamos 
primeiro ao showNewItem de nosso ViewController: 


OIBAction func showNewItem() 1 
let newltem = NewItemViewController(delegate: self) 
if let navigation - navigationController 1 
navigation.pushViewController(newItem, animated:true) 
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Aqui desejamos mostrar a mensagem padráo de erro: 


OIBAction func showNewItem() ( 
let newltem = NewItemViewController(delegate: self) 
if let navigation = navigationController 1 
navigation.pushViewController(newItem, animated:true) 
} else { 
Alert (controller: self).show() 


13.7 CASOS MAIS COMPLEXOS DE TRATAMENTO DE 
ERRO 


Na mesma classe, temos a função add, um caso mais complicado: 


if nameField == nil || happinessField == nil { 
return 


E agora? Duas condições? 


if let nameField = nameField { 
if let happinessField = happinessField { 
let name = nameField.text 
let happiness = happinessField.text.toIntO 
/] wes 
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IFLETX-X 


A construcáo if let permite definir uma variável com o mesmo 
nome da variável opcional que estamos testando. Isso pode parecer uma 
ótima funcionalidade, mas se o nome da variável opcional é igual ao 
nome da variável que tem valor, isso significa que um programador de- 
savisado pode acreditar que variável tem valor. Perigoso. 

Como em Swift será necessário o uso do !, ou ?, ou let para extrair 
o valor, o compilador pegará o erro do desenvolvedor (exceto em casos 
em que a inferéncia de tipo pode ser "esperta" e passar uma rasteira nele). 

Em outras linguagens, é ainda mais importante que uma variável in- 


dique se seu valor é opcional ou sempre válido. 











13.8 CODE SMELL: NESTED IFS 


Nested ifs? Bem feio. Ainda mais agora que precisamos de um terceiro 
if para resgatar o terceiro valor, o inteiro: 


if let nameField = nameField { 
if let happinessField = happinessField 1 
let name - nameField.text 
let happiness = happinessField.text.toInt() 
if let happiness = happiness 1 
// 


Haja coração para aturar esse código: cinco linhas pequenas com trés 
ifs, cinco lets, quatro names, seis happiness e seis Fields. Os 
nested ifs (ifs aninhados) são um indicador de que há muita responsa- 
bilidade e complexidade em nosso código. Paremos um instante e façamos a 
pergunta a nós mesmos: o que queremos aqui? 

Dado um formulário, quero um Meal. Ótimo, isolemos esse comporta- 
mento, a responsabilidade de, dado um formulário UI, extrair um Meal: 
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func getMealFromForm() -> Meal { 


Claro, falta implementar o método, que deixaremos como estava antes: 


func getMealFromForm() -> Meal 1 
if nameField == nil || happinessField == nil { 
return 


let name - nameField!.text 
let happiness - happinessField!.text.toInt() 
if happiness == nil 1 

return 


let meal = Meal(name: name, happiness: happiness!) 
meal.items - selected 
printin( 

"eaten: N(meal.name) N(meal.happiness) N(meal.items)") 


Quando percebemos que temos algo inválido, devolvemos vazio; no caso 
de sucesso, devolvemos nosso meal: 


func getMealFromForm() -> Meal 1 
if nameField == nil || happinessField == nil { 
return nil 


let name = nameField! .text 
let happiness = happinessField!.text.toInt() 
if happiness == nil 1 

return nil 


let meal = Meal(name: name, happiness: happiness!) 
meal.items = selected 
printin( 
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"eaten: N(meal.name) N(meal.happiness) N(meal.items)") 
return meal 


Mas calma, se podemos retornar um meal ou náo, o retorno deve ser 
marcado como opcional, para quem invocar esse método lembrar de tratar o 
caso de vazio: 


func getMealFromForm() -> Meal? { 
if nameField == nil || happinessField == nil { 
return nil 


let name - nameField!.text 
let happiness - happinessField!.text.toInt() 
if happiness == nil 1 

return nil 


let meal - Meal(name: name, happiness: happiness!) 
meal.items - selected 
printin( 

"eaten: N(meal.name) N(meal.happiness) N(meal.items)") 
return meal 


Agora invocamos o método adequadamente: 


OIBAction func add() 1 
if let meal = getMealFromForm() 1 
if delegate == nil { 
return 


delegate!.add(meal) 


if let navigation = self.navigationController 1 
navigation.popViewControllerAnimated (true) 
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Podemos melhorar a validacáo do delegate com um if let: 


OIBAction func add() 1 
if let meal = getMealFromForm() 1 
if let meals = delegate { 
meals.add(meal) 
if let navigation = self.navigationController 1 
navigation.popViewControllerAnimated (true) 


Apesar de nào ser o ideal, nào vamos refatorar mais nosso código. Os 
nested ifs que restaram podem ser refatorados, principalmente criando 
algum tipo de framework para lidar com delegates e navegação. O que 
faremos é mostrar um alerta no caso de problema de navegação: 


OIBAction func add() 1 
if let meal = getMealFromForm() 1 
if let meals = delegate { 
meals.add(meal) 
if let navigation = self.navigationController 1 
navigation.popViewControllerAnimated (true) 
} else { 
Alert(controller: self) .show( 
message: "Unexpected error, but the meal was added.") 


} 


Em caso de sucesso, saímos da função; caso surja outra falha, mostramos 
a mensagem padrão de erro: 


@IBAction func add() { 
if let meal = getMealFromForm() 1 
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if let meals = delegate { 
meals .add (meal) 
if let navigation = self.navigationController { 
navigation.popViewControllerAnimated(true) 
} else { 
Alert (controller: self) .show( 
message: "Unexpected error, but the meal was added.") 


} 


return 


} 
Alert (controller: self).show() 


13.9 RESUMO 


Vimos como o uso do optionals é poderoso e ao mesmo tempo extremamente 
perigoso. Conversamos sobre o perigo do ! e qual o motivo para evitá-lo ao 
máximo. Analisamos o uso do ? para fazer optional chaining eos peri- 
gos ainda mais graves em sua utilização. Por fim, optamos por usaro if let 
sempre, como a única alternativa segura ao trabalhar com valores opcionais. 
Vale lembrar que sempre daremos preferência para valores obrigatórios. 

O resto do código criado até agora em nossos outros controllers e classes 
pode se beneficiar da mesma técnica, na qual evitamos copy e paste e favore- 
cemos a extração de código comum, de responsabilidades. 

Aprendemos o princípio de responsabilidade única, fandamental para fa- 
cilitar a manutenção de nosso código em longo prazo. 

No meio do caminho, aprendemos como criar parâmetros opcionais e os 
cuidados que devemos tomar com eles. Isolamos o código de visualização de 
alertas em uma classe que foi reutilizada em todos os pontos de nossa aplica- 
ção em que valores opcionais são encontrados. 
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CAPÍTULO 14 


Removendo uma refeicáo 


14.1 AÇÕES DESTRUTIVAS E ESTILOS 


Nosso próximo passo é permitir que o usuário final seja capaz de remover 
uma refeição quando entrar com algum dado errado. Para isso, primeiro al- 
teramos nosso botão que é referenciado através de uma variável chamada ok 


para cancel, além de mudar seu nome para Cancel: 


func showDetails(recognizer: UlLongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view as UlTableViewCell 
let indexPath = tableView.indexPathForCell(cell) 
if indexPath == nil ( 
return 
h 


let row - indexPath!.row 
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let meal = meals[ row ] 


let details = UlAlertController(title: meal.name, 
message: meal.details(), 
preferredStyle: UlAlertControllerStyle.Alert) 


let cancel - UlAlertAction(title: "Cancel", 
Style: UIAlertActionStyle.Cancel, 
handler: nil) 

details.addAction(cancel) 


presentViewController( 
details, animated: true, completion: nil) 


Agora adicionamos um novo botáo, chamado Remove: 


let remove = UlAlertAction(title: "Remove", 
style: UlAlertActionStyle.Cancel, 
handler: nil) 

details.addAction(remove) 

let cancel = UlAlertAction(title: "Cancel", 
style: UlAlertActionStyle.Cancel, 
handler: nil) 

details.addAction(cancel) 


Note que temos um problema: uma ação de cancel não é destrutiva, 
enquanto uma de remove destrói algo, é uma ação perigosa e o usuário deve 
entender isso. Além disso, é muito estranho que um alerta tenha duas ações 
de cancelar, não faz sentido! Existe um estilo chamado Destructive que 
indica que a ação será destrutiva, e é ele que usaremos. 


let remove = UlAlertAction(title: "Remove", 
style: UlAlertActionStyle.Destructive, 
handler: nil) 

details.addAction(remove) 

let cancel = UlAlertAction(title: "Cancel", 
style: UlAlertActionStyle.Cancel, 
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handler: nil) 
details.addAction(cancel) 


Agora sim a caixa de diálogo nos diz que ao clicarmos em Remove algo 
perigoso acontecerá: 


Zucchini Muffin 
Happiness: 3 


Remove Cancel 





14.2 PASSANDO UMA FUNÇÃO COMO CALLBACK 


Mas clicamos e nada acontece. Como assim? Claro, precisamos escrever a 
função que será invocada pelo iOS quando o usuário clicar em Remove. Va- 
mos definir um método chamado removeSelected dentro de nossa classe: 


func removeSelected() { 
println("removed the selected one") 


Já passamos por outras situacóes em que dissemos para algum compo- 
nente de UI que, ao efetuar uma tarefa, um Observer devia ser chamado, 
passando tanto um objeto, comumente o self, e o nome do método atra- 
vés deum Selector - uma String. String? Como assim? Um perigo 
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só. Se qualquer coisa muda, a St ring nào é interpretada pelo compilador e 
somente descobrimos erros em tempo de execução. 

Em vez de trabalharmos com selectors, algumas partes da API do 
iOS nos permitem passar um bloco de código, uma função ou um método. 
Podemos passar diretamente como handler de nossa ação uma referência 
para a função removeSelected: 


let remove = UlAlertAction(title: "Remove", 
style: UlAlertActionStyle.Destructive, 
handler: removeSelected) 

details.addAction(remove) 

let cancel = UlAlertAction(title: "Cancel", 
style: UlAlertActionStyle.Cancel, 
handler: nil) 

details.addAction(cancel) 


Repare que não escrevemos removeSelected (), que seria o equiva- 
lente a invocar a função. Não queremos invocar a função, queremos somente 
passar a referência da função para o UIAlertAction. Por isso, passamos 
somente removeSelected. 

Mas o compilador reclama. Chato. Sim, esta é uma das ideias por trás de 
usar um compilador: pegar em desenvolvimento problemas que quebrariam 
nossa aplicação em tempo de execução. Ele indica que UIAlertAction! 
não pode ser convertido para (). Nossa função não recebe nada, e 
UIAlertAction! não pode ser convertido para nada. 


Vamos recebê-lo: 


func removeSelected(action:UIAlertAction!) 1 
println("removed the selected one") 
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CODE SMELL: USANDO COMPONENTES UI COMO PARÁMETROS 
EM OBSERVERS E O SWITCH 


Qual o motivo de receber nossa própria UIAlertAction como pa- 
râmetro ao executar a função atrelada a uma UIAlertAction? 

Uma função de callback como essa pode ser reutilizada por diver- 
sos eventos. Um exemplo disso é o prepareForSegue, um callback 





invocado quando qualquer segue de seu controller for ativado. O pro- 
blema de ter uma única função para duas ações ( segues são exemplos 
de acóes) diferentes é que precisamos agora criar uma sequéncia de ifs 
que verificam valores em tempo de execução: o compilador deixa de nos 
ajudar e passamos a ter uma função com alta complexidade ao invés de 
diversas funções com pouca complexidade. 

O que devemos fazer? Somente reutilize o mesmo callback, a mesma 
função, caso a ação a ser executada for realmente do mesmo tipo entre 
diversos botões, segues etc. Caso o código de uma ação não tenha 
nenhuma relação com o código de outra ação, não existe motivo para 
os dois estarem no mesmo método: crie duas funções e passe cada uma 
como argumento para quem irá invocá-la. 

Inicialmente, os autores do livro acreditavam que o modelo em que 
o cliente que é notificado das observações (ou, hoje em dia, um listener 
que é notificado de eventos) e conhece mais sobre o objeto que está ob- 
servando (modelo push) era um modelo que dificultava o reúso. Hoje 
em dia, Ralph Johnson defende em suas palestras que o modelo observers 
especializados são reutilizáveis, enquanto que genéricos não. 

Sendo assim, o uso de um mesmo observer (ou listener) para diversas 
ações totalmente diferentes, em que recebemos como parâmetro nosso 
componente UI para decidir o que fazer, é um cheiro de que é possí- 
vel que algo esteja ocorrendo de muito feio: muita complexidade com 
ifse switchs indica um cheiro ainda maior. Evite, ajude o próximo 
desenvolvedor e a manutenção de seu código: cada ação distinta é uma 
responsabilidade diferente e merece seu próprio método. 
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Rodamos nossa aplicacáo e, agora sim, efetuamoso 1ong pressemum 
dos elemento. Temos o resultado impresso no log ao selecionarmos a opção 


remove. 


removed the selected one 


All Output $ i [1 





14.3 INDENTIFICANDO A LINHA A SER REMOVIDA 


Gostaríamos agora de imprimir o nome da refeicáo que será removida, so- 
mente para conferir que está tudo ok. Mas como acessar a variável que foi 
definida em outro método? Como o método removeSelected acessa a va- 
riável mea1 dentro do método showDetails? Complicado... Cada variável 
tem seu próprio escopo e náo pode ser acessada fora dele: 


func showDetails(recognizer: UlLongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell = recognizer.view as UlTableViewCell 
let indexPath = tableView. indexPathForCell (cell) 
if indexPath == nil ( 
return 
h 
let row - indexPath!.row 
let meal - meals[ row ] 


// code that shows the controller 


func removeSelected(action:UIAlertAction!) 1 
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println("removed the selected one Y(meal.name)") 


Podemos criar uma variável opcional em nosso 
MealsTableViewController que representa a refeição  selecio- 
nada, atribuir um valor dentro do método que seleciona e aplicá-lo no 





removeSelected. Difícil? 


var selectedMeal:Meal? 


func showDetails(recognizer: UlLongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view as UlTableViewCell 
let indexPath = tableView.indexPathForCell(cell) 
if indexPath == nil 1 
return 
Y 
let row - indexPath!.row 
let meal - meals[ row ] 
selectedMeal - meal 


// code that shows the controller 


func removeSelected(action:UIAlertAction!) 1 
if let meal = selectedMeal ( 
println("removed the selected one Y(meal.name)") 


Complicado e feio, feio demais. Quanto mais tentamos "globalizar" nos- 
sas variáveis, e perder o escopo, perdemos o controle sobre elas. Deixá-las 
como opcionais? Estamos perdendo ainda mais o controle sobre o que está 
acontecendo e qual a situacáo atual de nossos objetos. Nào vamos por esse 
caminho. 

Note que a função removeSelected náo precisa necessariamente vi- 
ver dentro de nossa classe. Nossa funcáo é um método, por ser definida 
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na classe, podendo ser invocada como um comportamento dos objetos do 
tipo MealsTableViewController. Mas náo precisamos disso. Só pre- 
cisamos dela dentro do método showDetails. É somente ao mostrar os 
detalhes de uma refeição que é necessário uma função capaz de remover refei- 
ções. O que fazer? Colocamos a função removeSelected dentro de nosso 
showDetails). Uma função pode existir dentro de outra, não tem problema 


nenhum nisso: 


func showDetails(recognizer: UILongPressGestureRecognizer)í 
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if recognizer.state == UlGestureRecognizerState.Began { 


let cell = recognizer.view as UlTableViewCell 
let indexPath - tableView.indexPathForCell(cell) 
if indexPath == nil 1 

return 
} 
let row = indexPath!.row 
let meal = meals[ row ] 


func removeSelected(action:UIAlertAction!) { 
println("removed the selected one \(meal.name)") 


let details = UlAlertController(title: meal.name, 
message: meal.details(), 
preferredStyle: UlAlertControllerStyle.Alert) 


let remove - UlAlertAction(title: "Remove", 
style: UIAlertActionStyle.Destructive, 
handler: removeSelected) 

details.addAction(remove) 

let cancel - UlAlertAction(title: "Cancel", 
style: UIAlertActionStyle.Cancel, 
handler: nil) 

details.addAction(cancel) 

presentViewController( 
details, animated: true, completion: nil) 
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Removemos a definição anterior da função (não se esqueça!) e tudo conti- 
nua compilando! Claro, removeSelected continua sendo uma referência 
para uma função. Antes, a função era especial, um método. Agora, a fun- 
ção também é especial, uma função definida dentro de nosso código. Escopo 
controlado, mas ambas são funções e podem ser referenciadas. 


removed the selected one Zucchini Muffin 


All Output é W O0 | 





14.4 REMOVENDO E ATUALIZANDO A TELA 
O próximo passo é remover de verdade usando o removeAt Index: 


func showDetails(recognizer: UlLongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view as UlTableViewCell 
let indexPath - tableView.indexPathForCell(cell) 
if indexPath == nil ( 
return 
h 
let row - indexPath!.row 
let meal - meals[ row ] 


func removeSelected(action:UIAlertAction!) 1 
println("removed the selected one Y(meal.name)") 
meals.removeAtIndex(row) 


// show the controller 
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Testamos agora nossa aplicação, mas a tabela continua inteira. Clicamos 
novamente em remover para apagar a última refeição da lista, e a aplicação 
crasheia. O que acontece? Ele tenta acessar o array em uma posição inválida! 
Como assim? Já havíamos mencionado a importância de atualizarmos nossa 
tabela toda vez que o array for atualizado, e acabamos de cometer esse erro. 
Atualizamos o array mas não pedimos para a tabela ser redesenhada - e ela 
não foi. 


Mudemos nosso removeSelected para atualizá-la: 


func showDetails(recognizer: UlLongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
// get the meal 


func removeSelected(action:UIAlertAction!) { 
println("removed the selected one N(meal.name)") 
meals.removeAtIndex(row) 
tableView.reloadData() 


// show the controller 


Agora sim, somos capazes de remover elementos. 


14.5 CLOSURES 


Já podemos remover nosso print In, que ficou desnecessário. O que mais 
podemos atualizar em nosso código? 

Uma outra maneira de criar uma funcáo que será utilizada poucas vezes 
é criá-la e já atribuí-la, seja para uma variável, seja como parámetro na in- 
vocação de um método. Por exemplo, podemos invocar o inicializador do 
UIAlertAction já passando nosso bloco (uma closure) que será invocado 
posteriormente. Como nosso bloco recebe um UIAlertAction e devolve 
nada, marcamos como (UIAlertAction) -» Void: 
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let remove = UlAlertAction(title: "Remove", 
style: UlAlertActionStyle.Destructive, 
handler: ((action:UIAlertAction!) -> Void in 
meals.removeAt Index (row) 
table.reloadData() 
» 


Como o compilador é capaz de inferir qual o tipo do parámetro, pois o 
estamos passando diretamente, náo precisamos defini-lo. A mesma coisa vale 
para o retorno, portanto nosso código fica assim: 


let remove - UlAlertAction(title: "Remove", 
Style: UlAlertActionStyle.Destructive, 
handler: { action in 
meals.removeAtIndex(row) 
table.reloadData() 
H 


Ótimo, mas ainda nào compila. Acontece que, para uma closure acessar 
uma propriedade de nossa classe, ela precisa deixar isso explícito através do 
uso do self: 


let remove = UIAlertAction(title: "Remove", 
style: UlAlertActionStyle.Destructive, 
handler: { action in 
self.meals.removeAtIndex(row) 
self.table.reloadData() 
» 


Agora sim, nosso código funciona como anteriormente, e estamos usando 
uma closure em vez de uma função ou um método. 


14.6 CODE SMELL: CLOSURES A RODO 


Como vimos, uma funcáo pode ser utilizada de diversas maneiras: ela pode 
ser declarada e utilizada diretamente como uma closure, pode ser definida 
dentro de nosso código como uma função normal ou ainda declarada em uma 
classe para funcionar como um método de nossos objetos. Por educação, não 
criamos funções globais. 
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Cada uma delas é aplicada com suas vantagens e desvantagens. Lembre- 
se: blocos e closures sáo mais difíceis de testar por compactar muito o con- 
teúdo. São às vezes chamados de conciso, mas não confunda ‘conciso’ - que 
exige clareza, sem ambiguidades - com “mínimo de digitação possível, que 
permite ambiguidade e por vezes dificulta a compreensão. 

Por mais tentador que seja adotar o uso de closures em todo canto, tome 
muito cuidado. No mundo selvagem de programação você verá isso acon- 
tecendo de maneira descontrolada: usando sem dó nem piedade. Não deixe 
que o descontrole e o uso de diversos comportamentos em um único método 
o dominem: ao colocar diversas closures em pouco espaço, muitos comporta- 
mentos tomam conta daquele código. Fuja dessa cilada, mantenha uma res- 
ponsabilidade por unidade de código. 


Estamos falando tanto de muita responsabilidade e qualidade de código, 
mas esta classe está bem feia. Não por ser muita digitação, mas sim por ter 
muita responsabilidade. Note que ela é responsável por tudo ligado à view 
de todas as refeições, mas também à view de remover uma refeição. Onde 
já se viu isso? Uma classe de view controller que lida com dois view 
controllers. Falta de respeito por dificultar a manutenção de nosso có- 
digo. Extrairemos nossa responsabilidade. 

Podemos primeiro extrair um método chamado show, uma operação de 
refatoração tradicional: 


func showDetails(recognizer: UlLongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view as UlTableViewCell 
let indexPath = tableView.indexPathForCell(cell) 
if indexPath == nil 1 
return 
h 
let row - indexPath!.row 
let meal = meals[ row ] 


show (meal) 


h 


func show(meal:Meal) { 
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let details = UlAlertController(title: meal.name, 
message: meal.details(), 
preferredStyle: UlAlertControllerStyle.Alert) 


let remove - UlAlertAction(title: "Remove", 
style: UlAlertActionStyle.Destructive, 
handler: { action in 
self.meals.removeAtIndex(row) 
self.tableView.reloadData() 

3) 

details.addAction(remove) 

let cancel - UlAlertAction(title: "Cancel", 
style: UlAlertActionStyle.Cancel, 
handler: nil) 

details.addAction(cancel) 

presentViewController( 
details, animated: true, completion: nil) 


Mas nosso código precisa mais do que a refeicáo, ele precisa também do 
número da linha. Não vamos começar a passar diversos parâmetros picados 
para o método. Daqui a pouco, ele precisa de um outro Int, deuma String. 
Se desejamos mostrar o diálogo de remover refeição, passemos o handler in- 
teiro de uma vez: 


func showDetails(recognizer: UlLongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view as UlTableViewCell 
let indexPath - tableView.indexPathForCell(cell) 
if indexPath == nil 1 
return 
F 
let row = indexPath! .row 
let meal = meals[ row ] 


show(meal, { action in 
self.meals.removeAtIndex(row) 
self.tableView.reloadData() 
» 
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} 


func show(meal:Meal, handler: (UIAlertAction!) -> Void) { 


let details = UlAlertController(title: meal.name, 
message: meal.details(), 
preferredStyle: UlAlertControllerStyle.Alert) 


let remove - UlAlertAction(title: "Remove", 
style: UlAlertActionStyle.Destructive, 
handler: handler) 

details.addAction(remove) 

let cancel = UlAlertAction(title: "Cancel", 
style: UlAlertActionStyle.Cancel, 
handler: nil) 

details.addAction(cancel) 

presentViewController( 
details, animated: true, completion: nil) 


Por fim, nosso método náo nos pertence: vamos extraí-lo para outra 


classe, uma classe que representa nossa view de remover refeição. Criamos 


no grupo views O arquivo RemoveMealController. swift, seguindo o 


mesmo estilo do nosso Alert.swift: 


class RemoveMealController { 
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let controller:UIViewController 
init(controller:UIViewController) { 
self.controller = controller 
} 
func show(meal:Meal, handler: (UIAlertAction!) -> Void) { 
let details - UlAlertController(title: meal.name, 
message: meal.details(), 
preferredStyle: UlAlertControllerStyle.Alert) 


let remove - UlAlertAction(title: "Remove", 
style: UIAlertActionStyle.Destructive, 
handler: handler) 

details.addAction(remove) 

let cancel - UlAlertAction(title: "Cancel", 
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Style: UlAlertActionStyle.Cancel, 
handler: nil) 
details.addAction(cancel) 
controller.presentViewController( 
details, animated: true, completion: nil) 


E usamos nossa nova classe: 


func showDetails(recognizer: UlLongPressGestureRecognizer)í 
if recognizer.state == UlGestureRecognizerState.Began { 
let cell - recognizer.view as UlTableViewCell 
let indexPath = tableView.indexPathForCell(cell) 
if indexPath == nil ( 
return 


} 
let row = indexPath! .row 
let meal = meals[ row ] 


RemoveMealController(controller: self) .show (meal, 
{ action in 
self.meals.removeAtIndex(row) 
self.table.reloadData() 
J) 


Agora tudo funciona e o código está mais bem extraído. Ganhamos muito 
com as vantagens de refatoração e garantias de compilação de nosso código. 


14.7 RESUMO 


Vimos neste capítulo como permitir a remoção de uma refeição, mas, para 
chegar até esse ponto e mesmo após alcançá-lo, passamos por diversas me- 
lhorias de nosso código. 

Aprendemos a criar um handler que poderia ser uma referência para uma 
função qualquer: desde uma closure até o método de um objeto específico. 
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Aprendemos a receber uma referéncia para uma funcáo em nosso código ao 
extrairmos um método e uma classe para isolar melhor as responsabilidades 
de nosso programa. Somos capazes agora de dizer o que é uma função, e 
quando ela está definida como uma mera função, uma closure ou um método 
de uma classe. 

Vimos também diversos cuidados que devemos tomar e possíveis refato- 


racóes a serem efetuadas para melhorar nosso código a cada novo passo que 
damos. 
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CAPÍTULO 15 


Armazenando as refeicóes dentro 
do file system 


Conseguimos criar e mostrar a lista de refeições, mas o que acontece quando 
fechamos a aplicação? Ao rodarmos novamente, vemos que os dados que es- 
tavam inseridos náo aparecem mais! Queremos que, uma vez que as refeicóes 
e os itens sejam cadastrados, eles continuem dentro da app. Para isso, preci- 
samos deixar de salvar nossos dados em memória e salvarmos no sistema de 
arquivos do aparelho toda vez que sairmos de nossa aplicação. 

Primeiro, vamos reconectar nossa tabela de itens para que ela volte a fun- 
cionar. Para isso, voltamos a selecionar a nossa TableView e conectamos 
seu IBOutlet com nossa variável no controller. 
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Referencing Outlets 


( tableView O View Controller e 


New Referencing Outlet O 


Uma classe que nos possibilita fazer isso éa NSKeyedArchiver. Ela per- 
mite converter qualquer objeto para um formato que pode ser gravado em um 
arquivo no sistema de arquivos, temos apenas que dizer quais dados de nosso 
objeto queremos que sejam armazenados. Mas como o NSKeyedArchiver 
sabe qual objeto pode e qual nào pode ser gravado? 

Para garantir que conseguimos responder a este formato, temos que im- 
plementar um método específico com o qual o NSKeyedArchiver sabe tra- 
balhar. É o que fazemos utilizando o protocolo NSCoding em nosso objeto 
Meal: 


class Meal : NSCoding { 
// 


Para o protocolo funcionar, precisamos que nossa classe herde os com- 
portamentos da classe NSobject. Portanto, na classe Meal vamos herdar 
de NSObject e assinar o protocolo NSCoding: 


class Meal : NS0bject, NSCoding 1 
// 


O compilador irá reclamar que nào implementamos o método do proto- 
colo, apesar de dizermos que o adotamos. Claro! Já sabemos como protocolos 
funcionam. Mas quais os comportamentos que precisamos ter? Primeiro, o 
NSKeyedArchiver deve ser capaz de transformar nossos objetos em algum 
valor que possa ser salvo, portanto precisamos de um método que, ao ser 
executado em um objeto, salva os dados dele, um método que encode nosso 
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objeto, que o serialize. Depois, precisaremos de um comportamento que per- 
mita desserializar, recuperar o objeto para a memória dadas as informações 
que estavam (em nosso caso) em um arquivo. Isso é, precisamos inicializar 
um objeto e ler os dados que já existiam, em outras palavras precisaremos de 
um inicializador para a deserialização. 

Vamos colocar o método encodeWithCoder, que é o responsável por 
transformar nosso objeto Meal em algo que possa ser gravado em disco, ou 
seja, encodar o nosso objeto. Esse método recebe um objeto do tipo NSCoder 
onde jogamos os dados de nosso objeto passando uma chave e o valor corres- 
pondente: 


class Meal : NSObject, NSCoding 1 
// 


func encodeWithCoder(aCoder: NSCoder) ( 
aCoder.encode0bject (self .name, forKey: "name" 
aCoder. encodeInteger (self .happiness, forKey: "happiness") 
aCoder .encode0bject (self. items, forKey: "items") 


Sabemos como encodar, mas e como buscaremos os dados do arquivo? 
Temos que fazer a volta! O protocolo NSCoding também define um inici- 
alizador para isso, para criar um objeto utilizando os dados do disco. Colo- 
camos o inicializador na nossa classe Meal decodando os dados a partir do 
NSCoder: 


class Meal : NSObject, NSCoding 1 
// 


init(coder aDecoder: NSCoder) 1 
self.name = aDecoder.decode0bjectForKey ("name") as String 
self .happiness = 
aDecoder.decodeIntegerForkKey ("happiness") 
self.items = 
aDecoder.decodeObjectForKey ("items") as Array<Item> 
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func encodeWithCoder(aCoder: NSCoder) ( 
aCoder.encodeÜObject(self.name, forKey: "name" 
aCoder.encodeInteger(self.happiness, forKey: "happiness") 
aCoder.encodeÜbject(self.items, forKey: "items") 


Deixando dessa forma, o Xcode vai reclamar pois o protocolo obriga que 
o construtor seja implementado por todas as classes, logo, precisamos colocar 
apalavra required na assinatura do método: 


class Meal : NS0bject, NSCoding 1 
// 


required init(coder aDecoder: NSCoder) { 
self.name = aDecoder.decodeÜObjectForKey("name") as String 
self.happiness - 
aDecoder.decodeIntegerForkKey ("happiness") 
self.items - 
aDecoder.decodeÜObjectForKey("items") as Array<Item> 


func encodeWithCoder(aCoder: NSCoder) ( 
aCoder.encode0bject (self .name, forKey: "name" 
aCoder.encodeInteger (self .happiness, forKey: "happiness") 
aCoder .encode0bject (self .items, forKey: "items") 
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BOA PRÁTICA: DESSERIALIZAÇÃO NA INICIALIZAÇÃO 


De qual outra maneira poderíamos ter feito, em vez de implementar 
a desserialização no construtor? Duas opções são bem comuns: uma em 
que implementamos um método, algo como decodeWithDecoder: 





func decodeWithDecoder(aDecoder: NSCoder) 1 
self.name = aDecoder.decode0bjectForKey ("name") as String 
self.happiness = 

aDecoder.decodeIntegerForKey ("happiness") 
self.items = 
aDecoder.decode0bjectForKey ("items") as Array<Item> 


Mas note que nessa abordagem seria impossível criarmos good 
citizens. A outra é a criação de um segundo objeto capaz de serializar 
e desserializar dados, alguém responsável pelo processo de serialização e 
desserialização de um modelo (algo como uma factory e de-factory, um 
converter): 


class MealConverter 1 
func decodeWithDecoder(aDecoder: NSCoder) -> Meal 1 
let name = aDecoder.decodeÜ0bjectForKey("name") as String 
let happiness = aDecoder.decodeIntegerForKey ("happiness") 
let items = 
aDecoder.decode0bjectForKey ("items") as Array<Item> 
let meal = Meal (name, happiness) 
meal.items = items 
return meal 


func encodeWithCoder(meal:Meal, aCoder: NSCoder) 1 
aCoder.encodeÜbject(meal.name, forKey: "name" 
aCoder.encodeInteger(meal.happiness, forKey: "happiness") 
aCoder .encode0bject (meal. items, forKey: "items") 


Enquanto na desserialização ainda temos um good citizen, a aborda- 
gem do encodeWithCoder quebra a regra básica de encapsulamento,, 
ao obrigar a conhecer tudo que uma refeição possui ao converter. 

Levando em conta o trade-off entre quebrar o good citizen 








e quebra de encapsulamento, a abordagem do NSCoding é a de 
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GOOD CITIZEN E O ARRAY DE ITENS 


Até agora usamos a definição dos itens de uma refeição após a cria- 
ção de um Meal. Continuaremos assim pelo nosso projeto, mas é clara- 
mente visível que, se uma refeição não tivesse seus itens alterados nunca, 
os mesmos poderiam ser configurados na inicializacáo, podendo manter 
a definição da variável items com um 1et, uma constante. 








INICIALIZANDO UM VIEW CONTROLLER COM NSCODER 


Agora podemos entender que quando herdamos de um 
UIViewController ganhamos de graça a capacidade de seriali- 
Zar nossos controllers e é justamente por isso que, ao criarmos 
um novo inicializador, devemos garantir que a inicialização também 
ocorrerá educadamente caso o cont roller seja deserializado, isto é, 


O init(coder aDecoder: NSCoder) seja invocado. 











Podemos fazer um Command-*Click no nome do protocolo, NSCoding 
e revisar como ele foi definido. Repare que ele possui as duas características 
mencionadas anteriormente: tanto o método encodeWithCode quanto o 
init devem ser definidos. 

Ensinamos como fazemos para encodar uma refeição, mas a refeição é 
composta por itens, logo, devemos ensinar como encodar os itens também. 
Na classe Item repetimos o mesmo processo que fizemos na classe Meal. 
Ela ficará da seguinte forma: 


class Item: NS0bject, Equatable, NSCoding 1 
let name:String 
let calories:Double 
init(name: String, calories: Double) 1 
self.name = name 
self.calories = calories 
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required init(coder aDecoder: NSCoder) { 
self.name = aDecoder.decode0bjectForKey ("name") as String 
self.calories = aDecoder.decodeDoubleForKey('calories") 


func encodeWithCoder(aCoder: NSCoder) 1 
aCoder.encode0bject (self .name, forKey: "name" 
aCoder. encodeDouble (self. calories, forKey: "calories") 


15.1 SALVANDO AS REFEIÇÕES NO SISTEMA DE ARQUI- 
vos 


Agora que conseguimos transformar os objetos, chegou o momento de sal- 
varmos os dados no nosso file system. Toda vez que criamos uma nova 
refeição, queremos salvar os dados de nossas refeições. Alteramos o método 
add de nosso MealsTableViewController para salvar os dados no ar- 
quivo usando o NSKeyedArchiver e tiramos as refeições que havíamos co- 
locado anteriormente, inicializando com um Array vazio: 


var meals = Array<Meal>() 


func add(meal: Meal) 1 
meals.append(meal) 
NSKeyedArchiver.archiveRootO0bject(meals, toFile: archive) 
tableView.reloadData() 


Precisamos saber onde criar o arquivo que queremos gravar e cujos dados 
queremos ler. Só podemos efetuar a leitura e a escrita de arquivos que estejam 
dentro do diretório de nossa aplicação, portanto obtemos o caminho para o 
diretório através da funcáo NSSearchPathForDirectoriesInDomains. 


override func viewDidLoad() ( 


let userDirs = NSSearchPathForDirectoriesInDomains( 
? 


t3 
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7 


t3 


?) 


Mas a função recebe trés parámetros. O primeiro indica que tipo de dire- 
tório estamos procurando, o diretório de documentos. O segundo indica qual 
domínio estamos procurando, o de usuários. Por fim, o terceiro argumento 
diz se desejamos que o caminho para o diretório seja absoluto ou relativo à 
home do usuário. Desejamos absoluto: 


override func viewDidLoad() 1 
let userDirs - NSSearchPathForDirectoriesInDomains( 
NSSearchPathDirectory.DocumentDirectory, 
NSSearchPathDomainMask.UserDomainMask, 
true) 


Invocar NSSearchPathForDirectoriesInDomains retorna, um ar- 
ray com todos os diretórios de usuários, mas como no iOS temos somente um 
usuário, podemos pegar sempre a primeira posicáo deste array. Montamos o 
nome do arquivo e, como ele será necessário tanto para ler quanto para escre- 
ver, criamos o diretório uma ünica vez dentro do método viewDidLoad. 


override func viewDidLoad() 1 
let userDirs - NSSearchPathForDirectoriesInDomains( 
NSSearchPathDirectory.DocumentDirectory, 
NSSearchPathDomainMask.UserDomainMask, 
true) 
let dir = userDirs[ O ] as String 
let archive = "N(dir)/eggplant-brownie-meals" 


Já podemos ler as refeições do arquivo caso ele já exista: 


var meals = Array<Meal>() 
override func viewDidLoad() ( 


let userDir = NSSearchPathForDirectoriesInDomains( 
NSSearchPathDirectory.DocumentDirectory, 
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NSSearchPathDomainMask.UserDomainMask, 
true) 
let dir = userDir[ O ] as String 
let archive = "N(dir)/eggplant-brownie-meals" 
if let loaded = 
NSKeyedUnarchiver.unarchiveO0bjectWithFile(archive) { 
self.meals = loaded as Array 


E no nosso método de salvar, usamos o mesmo arquivo: 


func add(meal: Meal) { 


meals.append(meal) 

let userDir = NSSearchPathForDirectoriesInDomains( 
NSSearchPathDirectory.DocumentDirectory, 
NSSearchPathDomainMask.UserDomainMask, 
true) 

let dir = userDir[ O ] as String 

let archive = "N(dir)/eggplant-brownie-meals" 

NSKeyedArchiver.archiveRootÜbject(meals, toFile: archive) 

tableView.reloadData() 


Mas... Copy e paste mesmo? Vamos refatorar nosso código e extrair um 


método, o getUserDir: 


func add(meal: Meal) { 


h 


meals.append(meal) 

let dir = getUserDir() 

let archive = "N(dir)/eggplant-brownie-meals" 
NSKeyedArchiver.archiveRootO0bject(meals, toFile: archive) 
tableView.reloadData() 


func getUserDir() -> String { 


let userDir = NSSearchPathForDirectoriesInDomains( 
NSSearchPathDirectory.DocumentDirectory, 
NSSearchPathDomainMask.UserDomainMask, 
true) 

return userDir[ O ] as String 
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} 
override func viewDidLoad() { 
let dir = getUserDir( 
let archive = "N(dir)/eggplant-brownie-meals" 
if let loaded - 
NSKeyedUnarchiver.unarchiveObjectWithFile(archive) ( 
self.meals = loaded as Array 


b 
b 
Agora vamos rodar nossa aplicação. Vemos a tabela limpa: 
iOS Simulator - iPhone 6 - iPhone 6 / iOS 8.1 (128411) 
Carrier = 12:46 PM -— 


Add 


Adicionamos uma nova refeicáo: um Sundubu (tofu coreano). No menu 
de Hardware, escolhemos a Home (ou restartamos o simulador do zero) e 
podemos ver que nossa refeição ainda está armazenada. 
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iOS Simulator - iPhone 6 - iPhone 6 / iOS 8.1 (128411) 


Carrier = 4:18 AM 
€ Back 
Name 
Happiness 
Add 


Eggplant Brownie 
Zucchini Muffin 
Cookie 

Coconut oil 
Chocolate frosting 
Chocolate chip 


sundubu 


new item 
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15.2 SALVANDO E LENDO ITENS NO SISTEMA DE ARQUI- 
VOS 


Conseguimos gravar as refeições, mas precisamos gravar também os 
itens separadamente. Vamos efetuar a mesma alteração em nosso 
ViewController. Primeiro, inicializamos o Array de itens vazio: 


var items = Array<Item>() 


Obtemos o caminho para o arquivo e montamos o nome dele dentro do 


viewDidLoad 


func getUserDir() -> String { 
let userDir = NSSearchPathForDirectoriesInDomains( 
NSSearchPathDirectory.DocumentDirectory, 
NSSearchPathDomainMask.UserDomainMask, 
true) 
return userDir[ O ] as String 
+ 
override func viewDidLoad() 1 
// Creating button... 


let dir = getUserDir() 


let archive = "N(dir)/eggplant-brownie-items" 
} 

Carregamos também os dados do arquivo dentro de nossa variável 
items: 


override func viewDidLoad() 1 
// Creating button... 


let dir = getUserDir() 
let archive = "N(dir)/eggplant-brownie-items" 


if let loaded = 


NSKeyedUnarchiver.unarchiveObjectWithFile(archive) 1 
items = loaded as Array 
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Por fim, salvamos os dados no arquivo dentro do método addNew: 


func addNew(item: Item) { 

items.append(item) 
let dir - getUserDir() 
let archive = "N(dir)/eggplant-brownie-items" 
NSKeyedArchiver.archiveRootÜbject(items, toFile: archive) 
if let table = tableView { 

table.reloadData() 
} else { 

Alert (controller: self).show(message: 

"Unexpected error, but the item was added.") 


Conseguimos acessar o diretório Library para procurarmos onde 
o arquivo foi gerado, fazendo cmd+shift+g no Finder e digitando 


~/Library: 





| Goto the folder: 


(Cancel) GOTA) 


O arquivo será gerado em um caminho parecido com o seguinte: 
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Name A 
v L3 Developer 
v CoreSimulator 
v [3 Devices 
> [3j SDSEOF63-1F0D-47E1-92C0-478E987F08D6 
» [3j 9A907470-483B-4482-84D5-57CD650AD91D 
> [3 9F54B341-F4D6-44BA-B761-D62260184A3C 
v (ÚN 35B1CD01-9AE2-4BBA-8388-0804D3ED971D 
v (data 
v [3 Containers 
» [i Bundle 
v É Data 
v [3 Application 
> [=] 6BDB3880-7EE0-4845-8DE0-0823100F9776 
> (MI 9F9A8746-6B1A-45F2-8230-898A68559478 
v [3] 22CE76CF-182C-4168-85FC-90DBODCF32CE 
v [3 Documents 
 eggplant-brownie-items 
| eggplant-brownie-meals 


Como agora os dados pré-cadastrados náo existem mais, rodamos e cri- 
amos novamente um novo item chamado cheese com 100 calorias, um item 
chamado cookie, e adicionamos os dois em uma nova refeicáo chamada che- 
esecake com nível de felicidade 5. Ao efetuarmos o 1ong press, podemos 
ver que os dados foram cadastrados com sucesso: 
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Cheesecake 


Happiness: 5 
* Cheese - calories: 100.0 
* Cookie - calories: 10.0 


Ok Excluir 
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Para verificarmos se os itens continuam lá mesmo após sairmos de nossa 
aplicação, é só fazer cmd* shift th no simulador, que ele fechará a aplicação: 
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iOS Simulator - iPhone 5 - iPhone 5 / iOS 8.1... 
Carrier = 11:08 PM 


Extras eggplant-b... 
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Ao clicarmos na aplicação, podemos ver que a refeição adicionada conti- 
nua lá. 


Resumo 


Neste capítulo, vimos como transformar objetos para serem salvos e recu- 
perados através do protocolo NSCoding etambém como manipular arquivos 
utilizando NSKeyedArchivere NSKeyedUnarchiver. 

Aprendemos como o protocolo NSCoding obriga náo só a implemen- 
tacáo de um método como também a existéncia de um inicializador do tipo 
required. Vimos também como, ao sair e voltar a nossa aplicação, os dados 
foram carregados do sistema de arquivos, inclusive sendo capazes de localizá- 
los em nosso computador. 

No trajeto até aqui extraímos uma função que nos auxilia a definir o dire- 
tório de armazenamento de dados, mas ainda parece que temos muito copy 
e paste, algo que devemos atacar no próximo capítulo. 
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CAPÍTULO 16 

Boa prática: dividindo 
responsabilidades e o Data 
Access Object 


Conseguimos salvar e buscar os dados com sucesso, porém nosso controller 
acabou ficando com muitas responsabilidades: além de representar e respon- 
der as ações da view e de interagir com outras, agora ele é responsável por 
armazenar e ler os dados do disco. Temos que pensar ainda que cada control- 
ler está cuidando de seus próprios dados, repetindo, por exemplo, a lógica 
para buscarmos o diretório onde criamos os nossos arquivos. E se algum dia 
resolvermos armazenar os dados de uma outra forma? Teremos que alterar 
em todos os controllers esta nossa lógica. Para nào termos este problema, va- 
mos criar uma outra classe no grupo models, que terá a responsabilidade 
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de trabalhar com o armazenamento de dados. Para isso, escolhemos o menu 


File, New, iOS, Source, Swift File e damos o nome de Dao: 


class Dao { 


Em nosso Dao, criamos as variáveis que váo receber o nome de nossos 


arquivos: 


class Dao { 
let mealsArchive: String 
let itemsArchive: String 


Vamos efetuar também o carregamento dos dados no momento em que 
inicializarmos o Dao. Criamos o construtor para ele, onde buscamos o dire- 
tório do usuário uma ünica vez e montamos os nomes dos dois arquivos que 
utilizaremos: 


init Ot 

let userDir = NSSearchPathForDirectoriesInDomains( 
NSSearchPathDirectory.DocumentDirectory, 
NSSearchPathDomainMask.UserDomainMask, 
true) 

let dir = userDir[0] as String 

mealsArchive = "N(dir)/eggplant-brownie-meals" 

itemsArchive = "N(dir)/eggplant-brownie-items" 


Agora criamos o método para salvar e carregar as refeições: 


func saveMeals (meals: Array«Meal»)í 
NSKeyedArchiver.archiveRootObject( 
meals, toFile: mealsArchive) 
} 
func loadMeals() -> Array<Meal> { 
if let loaded = 
NSKeyedUnarchiver.unarchiveObjectWithFile(mealsArchive) 1 
return loaded as Array 
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Mas precisamos cuidar do caso de o arquivo náo existir, em que retorna- 
mos um array vazio: 


func loadMeals() -> Array<Meal> 1 
if let loaded - 
NSKeyedUnarchiver.unarchiveObjectWithFile(mealsArchive) 1 
return loaded as Array 


} 


return Array<Meal>() 


Vamos salvar e carregar itens: 


func saveItems (items: Array<Item>){ 
NSKeyedArchiver.archiveRootObject( 
items, toFile: itemsArchive) 
+ 
func loadItems() -> Array<Item> { 
if let loaded - 
NSKeyedUnarchiver.unarchiveObjectWithFile(itemsArchive) 1 
return loaded as Array 


+ 


return Array<Item>() 





Um DAO POR MODELO 


Em aplicações maiores, é comum utilizar uma classe de DAO por mo- 
delo, ou ainda, algum outro tipo de divisão de responsabilidades de sal- 
var e carregar dados de uma fonte. No nosso projeto, em que possuímos 
somente quatro métodos de uma linha, não há a necessidade de refinar 
ainda mais a responsabilidade de tais classes. Como um bom programa- 
dor, sempre julgue com cuidado o momento no qual acredita ser ade- 
quada a quebra de responsabilidades. 
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Code smell: nome do tipo no nome da variável, método etc 


Repare qual a palavra que se repete em cada uma das linhas; e quantas 
vezes? 


func saveltems(items: Array<Item>) 
func saveMeals(meals: Array<Meal>) 
func loadMeals() -> Array<Meal> 
func loadItems() -> Array<Item> 


Em uma linguagem como Swift, o próprio compilador é capaz de dizer 
qual método está sendo invocado de acordo com os tipos dos argumentos 
passados. Portanto, náo há necessidade de repetir o nome do tipo recebido 
como parámetro no nome de um método. As funções de save poderiam ser: 


func save(items: Array<Item>) 
func save(meals: Array<Meal>) 
func loadMeals() -> Array<Meal> 
func loadItems() -> Array<Item> 


Mas imagine como ficaria estranho se o mesmo ocorresse com o método 
load, que dependeria do tipo da variável ao qual o retorno está sendo apli- 
cado, para o compilador entender qual método está sendo invocado. Com- 
plexo. Por esse motivo, manteremos os padrões 1oadMeals e loadItems. 
Já que mantemos esse padrão no 1oad, manteremos o mesmo no save. 

O dia em que você como desenvolvedor julgar adequado quebrar o có- 
digo em dois Daos, poderá tranquilamente renomear os métodos para evitar 
repetição de nome de tipo em nome de método. 

Agora que o Dao está pronto, podemos alterar nossos controllers para 
utilizar este novo objeto. Primeiro, mudamos a classe ViewController 
para apenas chamar o método 1oadItems no viewDidLoad, removendo 
o código anterior onde buscávamos o diretório: 


override func viewDidLoad() 1 
let newlItemButton = UlBarButtonItem(title: "new item", 
style: UlBarButtonItemStyle.Plain, 
target: self, 
action: Selector("showNewItem")) 
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navigationlItem.rightBarButtonlItem = newItemButton 
items = DaoO .loadItems() 


No momento em que salvamos os dados, vamos chamar o método 


saveItems para guardar os itens no arquivo: 


func addNew(item: Item) 1 
items.append(item) 
Dao( .saveltems (items) 
if let table = tableView { 
table.reloadData() 
+ else 1 
Alert(controller: self).show(message: 
"Unexpected error, but the item was added.") 


Com o ViewController certo vamos arrumar agora O 
MealsTableViewController para buscar e salvar as refeições utili- 
zando os métodos loadMeals e saveMeals, removendo todo o código 
anterior de manipulacáo do arquivo: 


override func viewDidLoad() 1 
meals = Dao().loadMeals() 


func add(meal: Meal) 1 
meals.append(meal) 
Dao().saveMeals (meals) 
tableView.reloadData() 


Rodamos novamente e nossa aplicacáo continua funcionando da mesma 
forma. 


Resumo 


Tiramos responsabilidades exageradas de nossos controllers, isolando a 
funcionalidade de manipulação do arquivo, que na verdade é a de acesso aos 
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dados, em uma ünica classe. Ainda nào os deixamos com uma ünica respon- 
sabilidade, mas essa refatoracáo é mais um passo a caminho de um código 
mais fácil de se manter. Aprendemos com isso o padrão de projeto chamado 
Data Access Object, o DAO. 

Vimos também quando devemos quebrar essa responsabilidade em pe- 
daços ainda menores e como a nomenclatura de métodos e variáveis pode 
influenciar a legibilidade de nosso código. 
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CAPÍTULO 17 


Aonde chegamos e próximos 
passos 


Passamos juntos por uma longa jornada. Juntos pois o livro foi escrito à me- 
dida que a linguagem se desenvolvia, desde suas versóes beta (junto com o 
Xcode e Yosemite também beta), com muitas mudangas no caminho. 

A visáo geral da linguagem e mais aprofundada de alguns tópicos cria 
aqui uma base da linguagem que nos permite primeiramente escrever um 
código mais bonito. Náo estou falando de beleza por ter menos linhas ou 
ser funcional. A beleza de ter um código que funciona e que foi escrito com 
outros desenvolvedores em mente - com a preocupacáo da manutencáo. 

A utilizacáo de boas práticas e padróes de projeto nos ajudam a atingir 
tais objetivos. 


A partir de agora, descobrir novas funcionalidades da linguagem, explo- 


Casa do Código 





rar novas APIs, utilizar novas bibliotecas etc. passa a ser seu trabalho do dia 
a dia. Coloque tudo o que viu até aqui em prática, e que a nova geração de 
desenvolvedores iOS aproveite as melhores características da linguagem e da 
API para a mudança do mundo em que vivemos. 


Boa jornada. 
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